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

130 lines
4.7 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 异常的类型或消息文本来判断“页面在刷新”“上下文丢了”“连接断了”,
规则分散在 tab_pool(执行上下文)、page_lifecycle(页面刷新)、command_engine(断连)三处。
这里把它们合并成一个分类器,驱动实现抛出的都是下面这几种异常。
**翻译后的异常消息与原异常完全相同**(原异常保存在 ``__cause__`` 和 ``original`` 上),
所以迁移期间仍按字符串判断的旧代码不受影响。
"""
from __future__ import annotations
import contextlib
from typing import Iterator, Optional, Type
class DriverError(Exception):
"""驱动层错误的基类。"""
def __init__(self, message: str = "", original: Optional[BaseException] = None):
super().__init__(message)
self.original = original
class DriverDisconnected(DriverError):
"""与浏览器或标签页的连接已断开(标签页关闭、WebSocket 断开、浏览器退出)。"""
class ContextLost(DriverError):
"""页面执行上下文已失效:页面正在刷新、导航,或脚本所在的 frame 被销毁。通常稍后重试即可。"""
class DriverTimeout(DriverError, TimeoutError):
"""等待超时(元素、页面加载、脚本执行)。"""
class ScriptError(DriverError):
"""页面内脚本执行出错(JavaScript 异常、非法定位器等)。"""
_CONTEXT_LOST_MARKERS = (
"cannot find context with specified id",
"cannot find default execution context",
"execution context was destroyed",
"execution context is not available",
"context was destroyed",
"inspected target navigated or closed",
# page_lifecycle.is_page_refresh_error 的判定
"页面被刷新",
"page was refreshed",
"page is refreshing",
"page refreshed",
"try waiting for page refresh",
)
_DISCONNECTED_MARKERS = (
"连接已断开",
"connection disconnected",
"target closed",
"session closed",
"no target with given id",
"browser has disconnected",
)
def _drission_error_types():
try:
from DrissionPage import errors
except ImportError: # pragma: no cover - DrissionPage 为必装依赖
return {}
return {
"context": tuple(getattr(errors, n) for n in ("ContextLostError",) if hasattr(errors, n)),
"disconnected": tuple(
getattr(errors, n) for n in ("PageDisconnectedError", "BrowserConnectError", "TargetNotFoundError")
if hasattr(errors, n)
),
"timeout": tuple(getattr(errors, n) for n in ("WaitTimeoutError",) if hasattr(errors, n)),
"script": tuple(getattr(errors, n) for n in ("JavaScriptError", "LocatorError") if hasattr(errors, n)),
}
def classify_driver_error(error: BaseException) -> Type[DriverError]:
"""判断一个底层异常属于哪一类驱动错误(不修改异常本身)。"""
if isinstance(error, DriverError):
return type(error)
types = _drission_error_types()
text = str(error or "").lower()
if isinstance(error, types.get("context", ())) or any(m in text for m in _CONTEXT_LOST_MARKERS):
return ContextLost
if isinstance(error, types.get("disconnected", ())) or any(m in text for m in _DISCONNECTED_MARKERS) or (
"websocket" in text and "closed" in text
):
return DriverDisconnected
if isinstance(error, types.get("timeout", ())) or isinstance(error, TimeoutError):
return DriverTimeout
if isinstance(error, types.get("script", ())):
return ScriptError
return DriverError
def translate_error(error: BaseException) -> DriverError:
if isinstance(error, DriverError):
return error
return classify_driver_error(error)(str(error), original=error)
def _is_drission_error(error: BaseException) -> bool:
try:
from DrissionPage.errors import BaseError
except ImportError: # pragma: no cover
return False
return isinstance(error, BaseError)
@contextlib.contextmanager
def translated_errors() -> Iterator[None]:
"""只把 DrissionPage 自己的异常翻译成驱动异常;其他异常原样抛出。
Python 内置异常(TypeError、OSError、KeyError……)保持原样,调用方已有的 ``except TypeError`` 之类
的兼容逻辑因此不受影响——例如 network_monitor 先试 ``start(pattern, res_type=True)``,
旧版 DrissionPage 不认识该参数时抛 TypeError,再退回 ``start(pattern)``。
"""
try:
yield
except DriverError:
raise
except Exception as exc: # broad-except: 先判断类型,非 DrissionPage 异常原样重新抛出
if not _is_drission_error(exc):
raise
raise translate_error(exc) from exc