65 lines
2.1 KiB
Python
65 lines
2.1 KiB
Python
"""R2-1:浏览器驱动接口。
|
||
|
||
业务代码通过这里定义的接口访问浏览器,不再直接调用 DrissionPage。目前的实现:
|
||
- ``drission.DrissionTabDriver``:包装现有 DrissionPage 标签页对象,只转发调用、翻译异常;
|
||
- ``fake.FakeTabDriver``:内存假驱动,供单测使用,不需要真实浏览器。
|
||
|
||
迁移计划见 docs/architecture/browser-driver-and-process-model.md。网络监听(listen)
|
||
在第 5 步迁移时再加入接口,这里只包含已经实现的部分。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from typing import Any, List, Optional, Protocol, runtime_checkable
|
||
|
||
|
||
@runtime_checkable
|
||
class ElementHandle(Protocol):
|
||
@property
|
||
def tag(self) -> str: ...
|
||
|
||
@property
|
||
def text(self) -> str: ...
|
||
|
||
def attr(self, name: str) -> Optional[str]: ...
|
||
|
||
def click(self, *, by_js: bool = False) -> None: ...
|
||
|
||
def input(self, text: str, *, clear: bool = False) -> None: ...
|
||
|
||
def run_js(self, script: str, *args: Any) -> Any: ...
|
||
|
||
|
||
@runtime_checkable
|
||
class TabDriver(Protocol):
|
||
@property
|
||
def tab_id(self) -> str: ...
|
||
|
||
@property
|
||
def url(self) -> str: ...
|
||
|
||
@property
|
||
def title(self) -> str: ...
|
||
|
||
@property
|
||
def raw(self) -> Any:
|
||
"""底层对象(迁移期间的逃生口:尚未迁移的代码仍可拿到原始 DrissionPage 标签页)。"""
|
||
|
||
def run_js(self, script: str, *args: Any, timeout: Optional[float] = None, as_expr: bool = False) -> Any: ...
|
||
|
||
def run_cdp(self, method: str, **params: Any) -> Any: ...
|
||
|
||
def find(self, locator: str, timeout: Optional[float] = None) -> Optional[ElementHandle]:
|
||
"""timeout 为 None 时沿用驱动的默认等待。"""
|
||
|
||
def find_all(self, locator: str, timeout: Optional[float] = None) -> List[ElementHandle]: ...
|
||
|
||
def navigate(self, url: str, timeout: Optional[float] = None) -> bool: ...
|
||
|
||
def reload(self, ignore_cache: bool = False) -> None: ...
|
||
|
||
def screenshot(self, full_page: bool = False) -> bytes: ...
|
||
|
||
def insert_text(self, text: str) -> None:
|
||
"""在当前焦点处插入文本(CDP Input.insertText,不模拟逐键输入)。"""
|