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

36 lines
1.3 KiB
Python

"""R2-1:定位语法的统一规则(ElementFinder、健康巡检和各驱动共用)。
- 带 DrissionPage 前缀的原样使用:``css:``、``xpath:``、``tag:``、``@属性=值``、含 ``@@`` 的组合语法;
- 以 ``/`` 或 ``(`` 开头的按 XPath 处理(工作流执行器对这类选择器走 document.evaluate);
- 其余按 CSS 处理。
"""
from __future__ import annotations
DRISSION_PREFIXES = ("tag:", "@", "xpath:", "css:")
def to_locator(selector: str) -> str:
selector = str(selector or "").strip()
if selector.startswith(DRISSION_PREFIXES) or "@@" in selector:
return selector
if selector.startswith(("/", "(")):
return f"xpath:{selector}"
return f"css:{selector}"
def split_locator(locator: str) -> tuple:
"""把规范化后的定位器拆成 (类型, 表达式),类型为 css / xpath / tag / attr / drission。"""
locator = to_locator(locator)
if locator.startswith("css:"):
return "css", locator[4:]
if locator.startswith("xpath:"):
return "xpath", locator[6:]
if "@@" in locator:
return "drission", locator
if locator.startswith("tag:"):
return "tag", locator[4:]
if locator.startswith("@"):
return "attr", locator[1:]
return "drission", locator