立即生成并验证页面上任何元素的最佳剧作家定位器。
Playwright Locator Assistant 可帮助 QA 工程师和开发人员直接从浏览器生成、验证和管理 Playwright 定位器 — 无需使用 DevTools 深入研究，无需手动编写选择器。
──────────────────────────────────────────
立即生成最佳定位器
──────────────────────────────────────────
单击页面上的任何元素以捕获它，或使用键盘快捷键（Windows/Linux 上的 Alt+Shift+L，Mac 上的 ⌘+Shift+L）锁定光标下的元素，而无需单击 - 保持下拉菜单、菜单和悬停状态打开。
该扩展程序会按优先级自动选择可用的最强大的剧作家策略：
• getByTestId — 数据测试id、数据cy、数据qa、数据测试、数据自动化id、数据测试id
• getByRole 具有可访问的名称 — 按钮、链接、标题、输入等
• getByLabel — 用于与 <label> 关联的表单控件
• getByPlaceholder、getByAltText、getByTitle
• 原生<select> 下拉菜单——生成一个随时可用的selectOption() 调用
• 表格单元格 — 通过 .filter({ hasText }) 进行行锚定，因此定位器可以在行重新排序后继续存在
• 链式祖先定位器——当不存在全局唯一匹配时
• CSS 选择器后备 — 带有明确的警告以添加测试 ID
──────────────────────────────────────────
自动跳过动态值
──────────────────────────────────────────
汇率、价格、日期、时间和计数器在捕获时检测并从定位器中排除。您的测试在数据刷新期间保持绿色。
──────────────────────────────────────────
独特徽章
──────────────────────────────────────────
每个捕获的定位器都会立即针对当前页面进行检查：
✓ 1 — 独特搭配，使用安全
⚠ 3 — 不唯一，考虑更具体的定位器
✗ 0 — 未找到匹配项（页面状态可能已更改）
──────────────────────────────────────────
替代策略
──────────────────────────────────────────
展开任何捕获的定位器下方的“替代方案”面板，以查看同一元素的最多 5 个其他有效策略 - 每个策略都有自己的“复制”按钮。
──────────────────────────────────────────
参数化测试的变量
──────────────────────────────────────────
单击 { } 按钮可将表格单元格值、行标识符和选择选项转换为命名变量（JS 中的 rowText、cellValue、optionText；Python 中的 row_text、cell_value、option_text）——准备粘贴到参数化测试函数中。
──────────────────────────────────────────
验证任何定位器
──────────────────────────────────────────
将任何定位器粘贴到验证部分，扩展程序会用红色轮廓突出显示页面上的所有匹配元素。支持：
• Playwright 语法：getByRole、getByLabel、getByText、getByPlaceholder、getByAltText、getByTitle、getByTestId、locator()
• 链式定位器：page.getByRole("nav").getByRole("link", { name: "Home" })
• XPath: //div[@id="main"] 或 xpath=...
• 剧作家简写：text=Submit、css=.my-class
• 纯CSS 选择器
• Python Snake_case：get_by_role、get_by_label、select_option 等。
──────────────────────────────────────────
定位器历史记录
──────────────────────────────────────────
最后 8 个捕获的定位器将被保存并显示在弹出窗口中。每个条目都有自己的“复制”按钮，因此您可以构建完整的测试场景，而不会丢失早期的工作。
──────────────────────────────────────────
PYTEST 和 JavaScript 支持
──────────────────────────────────────────
随时在 Pytest (Python) 和 JavaScript 之间切换。每个定位器（包括选项、链接和精确标志）都针对您选择的框架进行了正确的格式化。
──────────────────────────────────────────
内置警告
──────────────────────────────────────────
<iframe> 或 Shadow DOM 内的元素被标记为内联，因此您可以准确地知道在定位器在测试中工作之前需要执行哪些额外步骤（frameLocator() 或 pierce: 选择器）。
──────────────────────────────────────────
如何使用
──────────────────────────────────────────
1. 在任意页面打开扩展弹窗。
2. 单击“选取元素”，然后单击页面上的任意元素，或者将鼠标悬停在元素上并按 Alt+Shift+L（在 Mac 上为 ⌘+Shift+L）立即捕获它。
3. 定位器出现在页面和弹出窗口中的叠加层中。直接复制就可以了。
4. 要验证定位器，请将其粘贴到“验证选择器”框中，然后单击“检查选择器”。
5. 最近的定位器保存在弹出窗口的第 3 部分中，以便快速访问。
对于原生 <select> 下拉列表：
单击下拉菜单将其打开，按 Escape 将其关闭（不选择），然后按快捷键。定位器是根据当前选择的值生成的 - 将其替换为您在测试中所需的选项。
