跳至主要内容

选择器

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


方法

注册

Added before v1.9 selectors.register

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

用法

一个注册选择器引擎的示例,该引擎基于标签名称查询元素:

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

(async () => {
// Must be a function that evaluates to a selector engine instance.
const createTagNameEngine = () => ({
// Returns the first element matching given selector in the root's subtree.
query(root, selector) {
return root.querySelector(selector);
},

// Returns all elements matching given selector in the root's subtree.
queryAll(root, selector) {
return Array.from(root.querySelectorAll(selector));
}
});

// Register the engine. Selectors will be prefixed with "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>`);

// Use the selector prefixed with its name.
const button = page.locator('tag=button');
// We can combine it with built-in locators.
await page.locator('tag=div').getByText('Click me').click();
// Can use it in any methods supporting selectors.
const buttonCount = await page.locator('tag=button').count();

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

参数

  • name string#

    在selectors中用作前缀的名称,例如{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。请注意,当此引擎与其他注册引擎一起使用时,不能保证以内容脚本方式运行。

返回


setTestIdAttribute

Added in: v1.27 selectors.setTestIdAttribute

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

用法

selectors.setTestIdAttribute(attributeName);

参数

  • attributeName string#

    测试ID属性名称。