summaryrefslogtreecommitdiffstats
path: root/testing/marionette/puppeteer/firefox/firefox_puppeteer/ui/base.py
blob: 622568df98568ca75e490125ce4730f067e84d0c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this file,
# You can obtain one at http://mozilla.org/MPL/2.0/.

from marionette_driver.marionette import HTMLElement

from firefox_puppeteer.base import BaseLib
from firefox_puppeteer.ui.windows import BaseWindow


class UIBaseLib(BaseLib):
    """A base class for all UI element wrapper classes inside a chrome window."""

    def __init__(self, marionette, window, element):
        super(UIBaseLib, self).__init__(marionette)

        assert isinstance(window, BaseWindow)
        assert isinstance(element, HTMLElement)

        self._window = window
        self._element = element

    @property
    def element(self):
        """Returns the reference to the underlying DOM element.

        :returns: Reference to the DOM element
        """
        return self._element

    @property
    def window(self):
        """Returns the reference to the chrome window.

        :returns: :class:`BaseWindow` instance of the chrome window.
        """
        return self._window


class DOMElement(HTMLElement):
    """
    Class that inherits from HTMLElement and provides a way for subclasses to
    expose new api's.
    """

    def __new__(cls, element):
        instance = object.__new__(cls)
        instance.__dict__ = element.__dict__.copy()
        setattr(instance, 'inner', element)

        return instance

    def __init__(self, element):
        pass