跳到主要内容

Selectors

选择器可用于安装自定义选择器引擎。更多信息请参见 可扩展性。

方法​

register​

在 v1.9 之前添加 selectors.register

选择器必须在创建页面之前注册。

用法

以下是一个注册基于标签名查询元素的选择器引擎的示例：

// 计算为选择器引擎实例的脚本。该脚本在页面上下文中计算。
String createTagNameEngine = "{\n" +
  "  // 返回根元素子树中与给定选择器匹配的第一个元素。\n" +
  "  query(root, selector) {\n" +
  "    return root.querySelector(selector);\n" +
  "  },\n" +
  "  // 返回根元素子树中与给定选择器匹配的所有元素。\n" +
  "  queryAll(root, selector) {\n" +
  "    return Array.from(root.querySelectorAll(selector));\n" +
  "  }\n" +
  "}";
// 注册引擎。选择器将以 "tag=" 为前缀。
playwright.selectors().register("tag", createTagNameEngine);
Browser browser = playwright.firefox().launch();
Page page = browser.newPage();
page.setContent("<div><button>Click me</button></div>");
// 使用以其名称为前缀的选择器。
Locator button = page.locator("tag=button");
// 将其与内置定位器结合使用。
page.locator("tag=div").getByText("Click me").click();
// 可在任何支持选择器的方法中使用它。
int buttonCount = (int) page.locator("tag=button").count();
browser.close();

参数​

  • name String# 选择器中用作前缀的名称，例如 {name: 'foo'} 可启用 foo=myselectorbody 选择器。只能包含 [a-zA-Z0-9_] 字符。
  • script String | Path# 计算结果为选择器引擎实例的脚本。该脚本在页面上下文中计算。
  • options Selectors.RegisterOptions（可选）
    • setContentScript boolean（可选）# 是否在隔离的 JavaScript 环境中运行此选择器引擎。此环境可以访问相同的 DOM，但无法访问框架脚本中的任何 JavaScript 对象。默认为 false。请注意，当此引擎与其他已注册的引擎一起使用时，不能保证作为内容脚本运行。

返回值​

setTestIdAttribute​

新增于：v1.27 selectors.setTestIdAttribute

定义在 Page.getByTestId() 中使用的自定义属性名称。默认使用 data-testid。

用法​

Selectors.setTestIdAttribute(attributeName);

参数

  • attributeName String#

    测试 ID 属性名称。