Selectors

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

---

方法

register

v1.9 版本前添加 selectors.register

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

用法

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

const { selectors, firefox } = require('@playwright/test');  // 或 'chromium' 或 'webkit'.

(async () => {
  // 必须是一个能求值为选择器引擎实例的函数
  const createTagNameEngine = () => ({
    // 返回根元素子树中第一个匹配给定选择器的元素
    query(root, selector) {
      return root.querySelector(selector);
    },

    // 返回根元素子树中所有匹配给定选择器的元素
    queryAll(root, selector) {
      return Array.from(root.querySelectorAll(selector));
    }
  });

  // 注册引擎。选择器将使用 "tag=" 前缀
  await selectors.register('tag', createTagNameEngine);

  const browser = await firefox.launch();
  const page = await browser.newPage();
  await page.setContent(`<div><button>Click me</button></div>`);

  // 使用带前缀的选择器
  const button = page.locator('tag=button');
  // 可以将其与内置定位器组合使用
  await page.locator('tag=div').getByText('Click me').click();
  // 可以在任何支持选择器的方法中使用
  const buttonCount = await page.locator('tag=button').count();

  await browser.close();
})();

参数

• name string#

  在选择器中用作前缀的名称，例如 {name: 'foo'} 启用 foo=myselectorbody 选择器。只能包含 [a-zA-Z0-9_] 字符。

• script function | string | Object#

  • path string (可选)

    JavaScript 文件路径。如果 path 是相对路径，则相对于当前工作目录解析。可选。

  • content string (可选)

    原始脚本内容。可选。

  求值为选择器引擎实例的脚本。该脚本在页面上下文中求值。

• options Object (可选)

  • contentScript boolean (可选)#

    是否在隔离的 JavaScript 环境中运行此选择器引擎。该环境可以访问相同的 DOM，但不能访问框架脚本中的任何 JavaScript 对象。默认为 false。注意当此引擎与其他注册引擎一起使用时，不能保证作为内容脚本运行。

返回值

• Promise<void>#

---

setTestIdAttribute

新增于: v1.27 selectors.setTestIdAttribute

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

用法

selectors.setTestIdAttribute(attributeName);

参数

• attributeName string#

  测试 ID 属性名称。