205 lines
4.7 KiB
Python
205 lines
4.7 KiB
Python
# -*- coding:utf-8 -*-
|
|
"""
|
|
@Author : g1879
|
|
@Contact : g1879@qq.com
|
|
@Website : https://DrissionPage.cn
|
|
@Copyright: (c) 2020 by g1879, Inc. All Rights Reserved.
|
|
"""
|
|
from typing import Union, Tuple, List, Optional, Literal
|
|
|
|
from .._base.chromium import Chromium
|
|
from .._elements.chromium_element import ShadowRoot, ChromiumElement
|
|
from .._pages.chromium_base import ChromiumBase
|
|
from .._pages.chromium_frame import ChromiumFrame
|
|
|
|
|
|
class ElementStates(object):
|
|
_ele: ChromiumElement = ...
|
|
|
|
def __init__(self, ele: ChromiumElement):
|
|
"""
|
|
:param ele: ChromiumElement
|
|
"""
|
|
...
|
|
|
|
@property
|
|
def is_selected(self) -> bool:
|
|
"""返回列表元素是否被选择"""
|
|
...
|
|
|
|
@property
|
|
def is_checked(self) -> bool:
|
|
"""返回元素是否被选择"""
|
|
...
|
|
|
|
@property
|
|
def is_displayed(self) -> bool:
|
|
"""返回元素是否显示"""
|
|
...
|
|
|
|
@property
|
|
def is_enabled(self) -> bool:
|
|
"""返回元素是否可用"""
|
|
...
|
|
|
|
@property
|
|
def is_alive(self) -> bool:
|
|
"""返回元素是否仍在DOM中"""
|
|
...
|
|
|
|
@property
|
|
def is_in_viewport(self) -> bool:
|
|
"""返回元素是否出现在视口中,以元素click_point为判断"""
|
|
...
|
|
|
|
@property
|
|
def is_whole_in_viewport(self) -> bool:
|
|
"""返回元素是否整个都在视口内"""
|
|
...
|
|
|
|
@property
|
|
def is_covered(self) -> Union[Literal[False], int]:
|
|
"""返回元素是否被覆盖,与是否在视口中无关,如被覆盖返回覆盖元素的backend id,否则返回False"""
|
|
...
|
|
|
|
@property
|
|
def is_clickable(self) -> bool:
|
|
"""返回元素是否可被模拟点击,从是否有大小、是否可用、是否显示、是否响应点击判断,不判断是否被遮挡"""
|
|
...
|
|
|
|
@property
|
|
def has_rect(self) -> Union[Literal[False], List[Tuple[float, float]]]:
|
|
"""返回元素是否拥有位置和大小,没有返回False,有返回四个角在页面中坐标组成的列表"""
|
|
...
|
|
|
|
|
|
class ShadowRootStates(object):
|
|
_ele: ShadowRoot = ...
|
|
|
|
def __init__(self, ele: ShadowRoot):
|
|
"""
|
|
:param ele: ChromiumElement
|
|
"""
|
|
...
|
|
|
|
@property
|
|
def is_enabled(self) -> bool:
|
|
"""返回元素是否可用"""
|
|
...
|
|
|
|
@property
|
|
def is_alive(self) -> bool:
|
|
"""返回元素是否仍在DOM中"""
|
|
...
|
|
|
|
|
|
class BrowserStates(object):
|
|
_browser: Chromium = ...
|
|
_incognito: Optional[bool] = ...
|
|
|
|
def __init__(self, browser: Chromium):
|
|
"""
|
|
:param browser: Chromium对象
|
|
"""
|
|
...
|
|
|
|
@property
|
|
def is_alive(self) -> bool:
|
|
"""返回浏览器是否仍可用"""
|
|
...
|
|
|
|
@property
|
|
def is_headless(self) -> bool:
|
|
"""返回浏览器是否无头模式"""
|
|
...
|
|
|
|
@property
|
|
def is_existed(self) -> bool:
|
|
"""返回浏览器是否接管的"""
|
|
...
|
|
|
|
@property
|
|
def is_incognito(self) -> bool:
|
|
"""返回浏览器是否无痕模式"""
|
|
...
|
|
|
|
|
|
class PageStates(object):
|
|
_owner: ChromiumBase = ...
|
|
|
|
def __init__(self, owner: ChromiumBase):
|
|
"""
|
|
:param owner: ChromiumBase对象
|
|
"""
|
|
...
|
|
|
|
@property
|
|
def is_loading(self) -> bool:
|
|
"""返回页面是否在加载状态"""
|
|
...
|
|
|
|
@property
|
|
def is_alive(self) -> bool:
|
|
"""返回页面对象是否仍然可用"""
|
|
...
|
|
|
|
@property
|
|
def ready_state(self) -> Optional[str]:
|
|
"""返回当前页面加载状态,'connecting' 'loading' 'interactive' 'complete'"""
|
|
...
|
|
|
|
@property
|
|
def has_alert(self) -> bool:
|
|
"""返回当前页面是否存在弹窗"""
|
|
...
|
|
|
|
@property
|
|
def is_headless(self) -> bool:
|
|
"""返回浏览器是否无头模式"""
|
|
...
|
|
|
|
@property
|
|
def is_existed(self) -> bool:
|
|
"""返回浏览器是否接管的"""
|
|
...
|
|
|
|
@property
|
|
def is_incognito(self) -> bool:
|
|
"""返回浏览器是否无痕模式"""
|
|
...
|
|
|
|
|
|
class FrameStates(object):
|
|
_frame: ChromiumFrame = ...
|
|
|
|
def __init__(self, frame: ChromiumFrame):
|
|
"""
|
|
:param frame: ChromiumFrame对象
|
|
"""
|
|
...
|
|
|
|
@property
|
|
def is_loading(self) -> bool:
|
|
"""返回页面是否在加载状态"""
|
|
...
|
|
|
|
@property
|
|
def is_alive(self) -> bool:
|
|
"""返回frame元素是否可用,且里面仍挂载有frame"""
|
|
...
|
|
|
|
@property
|
|
def ready_state(self) -> str:
|
|
"""返回加载状态"""
|
|
...
|
|
|
|
@property
|
|
def is_displayed(self) -> bool:
|
|
"""返回iframe是否显示"""
|
|
...
|
|
|
|
@property
|
|
def has_alert(self) -> bool:
|
|
"""返回当前页面是否存在弹窗"""
|
|
...
|