mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
557 lines
17 KiB
Python
557 lines
17 KiB
Python
# -*- coding:utf-8 -*-
|
|
"""
|
|
@Author : g1879
|
|
@Contact : g1879@qq.com
|
|
"""
|
|
from pathlib import Path
|
|
from typing import Union, Tuple, List, Any
|
|
|
|
from .base import DrissionElement, BaseElement
|
|
from .chromium_base import ChromiumBase
|
|
from .chromium_frame import ChromiumFrame
|
|
from .chromium_page import ChromiumPage
|
|
from .commons.constants import NoneElement
|
|
from .session_element import SessionElement
|
|
from .setter import ChromiumElementSetter
|
|
from .waiter import ChromiumElementWaiter
|
|
from .web_page import WebPage
|
|
|
|
|
|
class ChromiumElement(DrissionElement):
|
|
|
|
def __init__(self,
|
|
page: ChromiumBase,
|
|
node_id: str = None, obj_id: str = None, backend_id: str = None):
|
|
self._tag: str = ...
|
|
self.page: Union[ChromiumPage, WebPage] = ...
|
|
self._node_id: str = ...
|
|
self._obj_id: str = ...
|
|
self._backend_id: str = ...
|
|
self._doc_id: str = ...
|
|
self._ids: ChromiumElementIds = ...
|
|
self._scroll: ChromiumElementScroll = ...
|
|
self._click: Click = ...
|
|
self._select: ChromiumSelect = ...
|
|
self._wait: ChromiumElementWaiter = ...
|
|
self._locations: Locations = ...
|
|
self._set: ChromiumElementSetter = ...
|
|
self._states: ChromiumElementStates = ...
|
|
self._pseudo: Pseudo = ...
|
|
|
|
def __repr__(self) -> str: ...
|
|
|
|
def __call__(self,
|
|
loc_or_str: Union[Tuple[str, str], str],
|
|
timeout: float = None) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
@property
|
|
def tag(self) -> str: ...
|
|
|
|
@property
|
|
def html(self) -> str: ...
|
|
|
|
@property
|
|
def inner_html(self) -> str: ...
|
|
|
|
@property
|
|
def attrs(self) -> dict: ...
|
|
|
|
@property
|
|
def text(self) -> str: ...
|
|
|
|
@property
|
|
def raw_text(self) -> str: ...
|
|
|
|
# -----------------d模式独有属性-------------------
|
|
@property
|
|
def ids(self) -> ChromiumElementIds: ...
|
|
|
|
@property
|
|
def size(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def set(self) -> ChromiumElementSetter: ...
|
|
|
|
@property
|
|
def states(self) -> ChromiumElementStates: ...
|
|
|
|
@property
|
|
def location(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def locations(self) -> Locations: ...
|
|
|
|
@property
|
|
def pseudo(self) -> Pseudo: ...
|
|
|
|
@property
|
|
def shadow_root(self) -> Union[None, ChromiumShadowRoot]: ...
|
|
|
|
@property
|
|
def sr(self) -> Union[None, ChromiumShadowRoot]: ...
|
|
|
|
@property
|
|
def scroll(self) -> ChromiumElementScroll: ...
|
|
|
|
@property
|
|
def click(self) -> Click: ...
|
|
|
|
def parent(self, level_or_loc: Union[tuple, str, int] = 1, index: int = 1) -> Union[ChromiumElement, None]: ...
|
|
|
|
def child(self, filter_loc: Union[tuple, str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = 0,
|
|
ele_only: bool = True) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def prev(self, filter_loc: Union[tuple, str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = 0,
|
|
ele_only: bool = True) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def next(self, filter_loc: Union[tuple, str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = 0,
|
|
ele_only: bool = True) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def before(self, filter_loc: Union[tuple, str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def after(self, filter_loc: Union[tuple, str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def children(self, filter_loc: Union[tuple, str] = '',
|
|
timeout: float = 0,
|
|
ele_only: bool = True) -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def prevs(self, filter_loc: Union[tuple, str] = '',
|
|
timeout: float = 0,
|
|
ele_only: bool = True) -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def nexts(self, filter_loc: Union[tuple, str] = '',
|
|
timeout: float = 0,
|
|
ele_only: bool = True) -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def befores(self, filter_loc: Union[tuple, str] = '',
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def afters(self, filter_loc: Union[tuple, str] = '',
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
@property
|
|
def wait(self) -> ChromiumElementWaiter: ...
|
|
|
|
@property
|
|
def select(self) -> ChromiumSelect: ...
|
|
|
|
def attr(self, attr: str) -> Union[str, None]: ...
|
|
|
|
def remove_attr(self, attr: str) -> None: ...
|
|
|
|
def prop(self, prop: str) -> Union[str, int, None]: ...
|
|
|
|
def run_js(self, script: str, *args: Any, as_expr: bool = False) -> Any: ...
|
|
|
|
def run_async_js(self, script: str, *args: Any, as_expr: bool = False) -> None: ...
|
|
|
|
def ele(self,
|
|
loc_or_str: Union[Tuple[str, str], str],
|
|
timeout: float = None) -> Union[ChromiumElement, str]: ...
|
|
|
|
def eles(self,
|
|
loc_or_str: Union[Tuple[str, str], str],
|
|
timeout: float = None) -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def s_ele(self, loc_or_str: Union[Tuple[str, str], str] = None) -> Union[SessionElement, str, NoneElement]: ...
|
|
|
|
def s_eles(self, loc_or_str: Union[Tuple[str, str], str] = None) -> List[Union[SessionElement, str]]: ...
|
|
|
|
def _find_elements(self, loc_or_str: Union[Tuple[str, str], str], timeout: float = None,
|
|
single: bool = True, relative: bool = False, raise_err: bool = False) \
|
|
-> Union[ChromiumElement, ChromiumFrame, str, NoneElement,
|
|
List[Union[ChromiumElement, ChromiumFrame, str]]]: ...
|
|
|
|
def style(self, style: str, pseudo_ele: str = '') -> str: ...
|
|
|
|
def get_src(self, timeout: float = None, base64_to_bytes: bool = True) -> Union[bytes, str, None]: ...
|
|
|
|
def save(self, path: [str, bool] = None, rename: str = None, timeout: float = None) -> None: ...
|
|
|
|
def get_screenshot(self, path: [str, Path] = None, as_bytes: [bool, str] = None,
|
|
as_base64: [bool, str] = None) -> Union[str, bytes]: ...
|
|
|
|
def input(self, vals: Any, clear: bool = True, by_js: bool = False) -> None: ...
|
|
|
|
def _set_file_input(self, files: Union[str, list, tuple]) -> None: ...
|
|
|
|
def clear(self, by_js: bool = False) -> None: ...
|
|
|
|
def _input_focus(self) -> None: ...
|
|
|
|
def focus(self) -> None: ...
|
|
|
|
def hover(self, offset_x: int = None, offset_y: int = None) -> None: ...
|
|
|
|
def drag(self, offset_x: int = 0, offset_y: int = 0, duration: float = 0.5) -> None: ...
|
|
|
|
def drag_to(self, ele_or_loc: Union[tuple, ChromiumElement], duration: float = 0.5) -> None: ...
|
|
|
|
def _get_obj_id(self, node_id: str = None, backend_id: str = None) -> str: ...
|
|
|
|
def _get_node_id(self, obj_id: str = None, backend_id: str = None) -> str: ...
|
|
|
|
def _get_backend_id(self, node_id: str) -> str: ...
|
|
|
|
def _get_ele_path(self, mode: str) -> str: ...
|
|
|
|
|
|
class ChromiumElementStates(object):
|
|
def __init__(self, ele: ChromiumElement):
|
|
self._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: ...
|
|
|
|
@property
|
|
def is_in_viewport(self) -> bool: ...
|
|
|
|
@property
|
|
def is_covered(self) -> bool: ...
|
|
|
|
|
|
class ChromiumShadowRoot(BaseElement):
|
|
|
|
def __init__(self,
|
|
parent_ele: ChromiumElement,
|
|
obj_id: str = None,
|
|
backend_id: str = None):
|
|
self._obj_id: str = ...
|
|
self._ids: Ids = ...
|
|
self._node_id: str = ...
|
|
self._backend_id: str = ...
|
|
self.page: ChromiumPage = ...
|
|
self.parent_ele: ChromiumElement = ...
|
|
self._states: ShadowRootStates = ...
|
|
|
|
def __repr__(self) -> str: ...
|
|
|
|
def __call__(self,
|
|
loc_or_str: Union[Tuple[str, str], str],
|
|
timeout: float = None) -> ChromiumElement: ...
|
|
|
|
@property
|
|
def ids(self) -> Ids: ...
|
|
|
|
@property
|
|
def states(self) -> ShadowRootStates: ...
|
|
|
|
@property
|
|
def tag(self) -> str: ...
|
|
|
|
@property
|
|
def html(self) -> str: ...
|
|
|
|
@property
|
|
def inner_html(self) -> str: ...
|
|
|
|
def run_js(self, script: str, *args: Any, as_expr: bool = False) -> Any: ...
|
|
|
|
def run_async_js(self, script: str, *args: Any, as_expr: bool = False) -> None: ...
|
|
|
|
def parent(self, level_or_loc: Union[str, int] = 1, index: int = 1) -> ChromiumElement: ...
|
|
|
|
def child(self, filter_loc: Union[tuple, str] = '',
|
|
index: int = 1) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def next(self, filter_loc: Union[tuple, str] = '',
|
|
index: int = 1) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def before(self, filter_loc: Union[tuple, str] = '',
|
|
index: int = 1) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def after(self, filter_loc: Union[tuple, str] = '',
|
|
index: int = 1) -> Union[ChromiumElement, str, None]: ...
|
|
|
|
def children(self, filter_loc: Union[tuple, str] = '') -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def nexts(self, filter_loc: Union[tuple, str] = '') -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def befores(self, filter_loc: Union[tuple, str] = '') -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def afters(self, filter_loc: Union[tuple, str] = '') -> List[Union[ChromiumElement, str]]: ...
|
|
|
|
def ele(self,
|
|
loc_or_str: Union[Tuple[str, str], str],
|
|
timeout: float = None) -> Union[ChromiumElement]: ...
|
|
|
|
def eles(self,
|
|
loc_or_str: Union[Tuple[str, str], str],
|
|
timeout: float = None) -> List[ChromiumElement]: ...
|
|
|
|
def s_ele(self, loc_or_str: Union[Tuple[str, str], str] = None) -> Union[SessionElement, str, NoneElement]: ...
|
|
|
|
def s_eles(self, loc_or_str: Union[Tuple[str, str], str]) -> List[Union[SessionElement, str]]: ...
|
|
|
|
def _find_elements(self, loc_or_str: Union[Tuple[str, str], str], timeout: float = None,
|
|
single: bool = True, relative: bool = False, raise_err: bool = None) \
|
|
-> Union[ChromiumElement, ChromiumFrame, NoneElement, str, List[Union[ChromiumElement,
|
|
ChromiumFrame, str]]]: ...
|
|
|
|
def _get_node_id(self, obj_id: str) -> str: ...
|
|
|
|
def _get_obj_id(self, back_id: str) -> str: ...
|
|
|
|
def _get_backend_id(self, node_id: str) -> str: ...
|
|
|
|
|
|
class Ids(object):
|
|
def __init__(self, ele: Union[ChromiumElement, ChromiumShadowRoot]):
|
|
self._ele: Union[ChromiumElement, ChromiumShadowRoot] = ...
|
|
|
|
@property
|
|
def node_id(self) -> str: ...
|
|
|
|
@property
|
|
def obj_id(self) -> str: ...
|
|
|
|
@property
|
|
def backend_id(self) -> str: ...
|
|
|
|
|
|
class ChromiumElementIds(Ids):
|
|
@property
|
|
def doc_id(self) -> str: ...
|
|
|
|
|
|
def find_in_chromium_ele(ele: ChromiumElement,
|
|
loc: Union[str, Tuple[str, str]],
|
|
single: bool = True,
|
|
timeout: float = None,
|
|
relative: bool = True) \
|
|
-> Union[ChromiumElement, str, NoneElement, List[Union[ChromiumElement, str]]]: ...
|
|
|
|
|
|
def find_by_xpath(ele: ChromiumElement,
|
|
xpath: str,
|
|
single: bool,
|
|
timeout: float,
|
|
relative: bool = True) -> Union[ChromiumElement, List[ChromiumElement], NoneElement]: ...
|
|
|
|
|
|
def find_by_css(ele: ChromiumElement,
|
|
selector: str,
|
|
single: bool,
|
|
timeout: float) -> Union[ChromiumElement, List[ChromiumElement], NoneElement]: ...
|
|
|
|
|
|
def make_chromium_ele(page: ChromiumBase, node_id: str = ..., obj_id: str = ...) \
|
|
-> Union[ChromiumElement, ChromiumFrame, str]: ...
|
|
|
|
|
|
def make_js_for_find_ele_by_xpath(xpath: str, type_txt: str, node_txt: str) -> str: ...
|
|
|
|
|
|
def run_js(page_or_ele: Union[ChromiumBase, ChromiumElement, ChromiumShadowRoot], script: str,
|
|
as_expr: bool = False, timeout: float = None, args: tuple = ...) -> Any: ...
|
|
|
|
|
|
def parse_js_result(page: ChromiumBase, ele: ChromiumElement, result: dict): ...
|
|
|
|
|
|
def convert_argument(arg: Any) -> dict: ...
|
|
|
|
|
|
def send_enter(ele: ChromiumElement) -> None: ...
|
|
|
|
|
|
def send_key(ele: ChromiumElement, modifier: int, key: str) -> None: ...
|
|
|
|
|
|
class ShadowRootStates(object):
|
|
def __init__(self, ele: ChromiumShadowRoot):
|
|
"""
|
|
:param ele: ChromiumElement
|
|
"""
|
|
self._ele: ChromiumShadowRoot = ...
|
|
|
|
@property
|
|
def is_enabled(self) -> bool: ...
|
|
|
|
@property
|
|
def is_alive(self) -> bool: ...
|
|
|
|
|
|
class Locations(object):
|
|
def __init__(self, ele: ChromiumElement):
|
|
self._ele: ChromiumElement = ...
|
|
|
|
@property
|
|
def location(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def midpoint(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def click_point(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def viewport_location(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def viewport_midpoint(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def viewport_click_point(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def screen_location(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def screen_midpoint(self) -> Tuple[int, int]: ...
|
|
|
|
@property
|
|
def screen_click_point(self) -> Tuple[int, int]: ...
|
|
|
|
def _get_viewport_rect(self, quad: str) -> Union[list, None]: ...
|
|
|
|
def _get_page_coord(self, x: int, y: int) -> Tuple[int, int]: ...
|
|
|
|
|
|
class Click(object):
|
|
def __init__(self, ele: ChromiumElement):
|
|
self._ele: ChromiumElement = ...
|
|
|
|
def __call__(self, by_js: Union[None, bool] = False, timeout: float = 1) -> bool: ...
|
|
|
|
def left(self, by_js: Union[None, bool] = False, timeout: float = 1) -> bool: ...
|
|
|
|
def right(self) -> None: ...
|
|
|
|
def middle(self) -> None: ...
|
|
|
|
def at(self, offset_x: int = None, offset_y: int = None, button: str = 'left', count: int = 1) -> None: ...
|
|
|
|
def twice(self, by_js: bool = False) -> None: ...
|
|
|
|
def _click(self, client_x: int, client_y: int, button: str = 'left', count: int = 1) -> None: ...
|
|
|
|
|
|
class ChromiumScroll(object):
|
|
def __init__(self, page_or_ele: Union[ChromiumBase, ChromiumElement, ChromiumFrame]):
|
|
self.t1: str = ...
|
|
self.t2: str = ...
|
|
self._driver: Union[ChromiumPage, ChromiumElement, ChromiumFrame] = ...
|
|
self._wait_complete: bool = ...
|
|
|
|
def _run_js(self, js: str): ...
|
|
|
|
def to_top(self) -> None: ...
|
|
|
|
def to_bottom(self) -> None: ...
|
|
|
|
def to_half(self) -> None: ...
|
|
|
|
def to_rightmost(self) -> None: ...
|
|
|
|
def to_leftmost(self) -> None: ...
|
|
|
|
def to_location(self, x: int, y: int) -> None: ...
|
|
|
|
def up(self, pixel: int = 300) -> None: ...
|
|
|
|
def down(self, pixel: int = 300) -> None: ...
|
|
|
|
def left(self, pixel: int = 300) -> None: ...
|
|
|
|
def right(self, pixel: int = 300) -> None: ...
|
|
|
|
def _wait_scrolled(self) -> None: ...
|
|
|
|
|
|
class ChromiumElementScroll(ChromiumScroll):
|
|
|
|
def to_see(self, center: Union[bool, None] = None) -> None: ...
|
|
|
|
|
|
class ChromiumSelect(object):
|
|
def __init__(self, ele: ChromiumElement):
|
|
self._ele: ChromiumElement = ...
|
|
|
|
def __call__(self, text_or_index: Union[str, int, list, tuple], timeout: float = None) -> bool: ...
|
|
|
|
@property
|
|
def is_multi(self) -> bool: ...
|
|
|
|
@property
|
|
def options(self) -> List[ChromiumElement]: ...
|
|
|
|
@property
|
|
def selected_option(self) -> Union[ChromiumElement, None]: ...
|
|
|
|
@property
|
|
def selected_options(self) -> List[ChromiumElement]: ...
|
|
|
|
def clear(self) -> None: ...
|
|
|
|
def all(self) -> None: ...
|
|
|
|
def by_text(self, text: Union[str, list, tuple], timeout: float = None) -> bool: ...
|
|
|
|
def by_value(self, value: Union[str, list, tuple], timeout: float = None) -> bool: ...
|
|
|
|
def by_index(self, index: Union[int, list, tuple], timeout: float = None) -> bool: ...
|
|
|
|
def by_loc(self, loc: Union[str, Tuple[str, str]], timeout: float = None) -> bool: ...
|
|
|
|
def cancel_by_text(self, text: Union[str, list, tuple], timeout: float = None) -> bool: ...
|
|
|
|
def cancel_by_value(self, value: Union[str, list, tuple], timeout: float = None) -> bool: ...
|
|
|
|
def cancel_by_index(self, index: Union[int, list, tuple], timeout: float = None) -> bool: ...
|
|
|
|
def cancel_by_loc(self, loc: Union[str, Tuple[str, str]], timeout: float = None) -> bool: ...
|
|
|
|
def invert(self) -> None: ...
|
|
|
|
def _by_loc(self, loc: Union[str, Tuple[str, str]], timeout: float = None, cancel: bool = False) -> bool: ...
|
|
|
|
def _select(self,
|
|
condition: Union[str, int, list, tuple] = None,
|
|
para_type: str = 'text',
|
|
cancel: bool = False,
|
|
timeout: float = None) -> bool: ...
|
|
|
|
def _text_value(self, condition: set, para_type: str, mode: str, timeout: float) -> bool: ...
|
|
|
|
def _index(self, condition: set, mode: str, timeout: float) -> bool: ...
|
|
|
|
def _dispatch_change(self) -> None: ...
|
|
|
|
|
|
class Pseudo(object):
|
|
def __init__(self, ele: ChromiumElement):
|
|
self._ele: ChromiumElement = ...
|
|
|
|
@property
|
|
def before(self) -> str: ...
|
|
|
|
@property
|
|
def after(self) -> str: ...
|