Files
2026-11-02 22:54:14 +08:00

65 lines
2.1 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""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,不模拟逐键输入)。"""