智能定位器与 DOM 选择
了解页面变化后图钉如何跟随元素,以及 Pinar 何时会要求手动放置。
5 分钟本指南内容
1
稳健指纹
元素图钉会组合稳定选择器、DOM 路径、标签、id、名称、测试 id、角色、类名、文本、标签和几何信息。重新打开时,Pinar 会评估选择器、结构、语义和几何,而不是只信任一条脆弱路径。
2
置信度与歧义
匹配可以是精确、可能、歧义或未解析。当两个候选项过于相似时,Pinar 会保留备选,而不是把图钉吸附到错误元素。跨源 iframe 目标可能保持未解析。
3
选择器回退与竞争匹配
捕获时,Pinar 优先使用能通过 id、data-testid 或 data-test,或标签加名称唯一匹配节点的选择器。如果这些都不唯一,它会改为存储结构化 CSS 路径。看起来像生成的类名会从指纹中去掉,以免哈希后的 CSS 模块成为唯一信号。
重新打开时,来自稳定选择器、结构、语义和几何策略的候选项会合并并排序。精确置信度需要高分的稳定选择器或结构命中;语义和几何匹配保持为可能。当前两个可行分数相差不到很窄的边距时,结果为歧义,不会选定任何元素。
- 当其他节点共享相同标签、文本和类名时,位置性 :nth-of-type 选择器得分更低。
- 区域图钉在作为元素目标时会被拒绝,并在定位器评分期间保持未解析。
- 当 iframe 的内容文档不可读时,重定位会以跨源 frame 警告停止,而不是猜测。
还需要更多背景?查看该分类全部内容