Selectors
选择器可用于安装自定义选择器引擎。更多信息请参阅可扩展性。
方法
注册
v1.9 之前添加必须在创建页面之前注册选择器。
用法
一个注册基于标签名查询元素的选择器引擎的示例
// Script that evaluates to a selector engine instance. The script is evaluated in the page context.
String createTagNameEngine = "{\n" +
" // Returns the first element matching given selector in the root's subtree.\n" +
" query(root, selector) {\n" +
" return root.querySelector(selector);\n" +
" },\n" +
" // Returns all elements matching given selector in the root's subtree.\n" +
" queryAll(root, selector) {\n" +
" return Array.from(root.querySelectorAll(selector));\n" +
" }\n" +
"}";
// Register the engine. Selectors will be prefixed with "tag=".
playwright.selectors().register("tag", createTagNameEngine);
Browser browser = playwright.firefox().launch();
Page page = browser.newPage();
page.setContent("<div><button>Click me</button></div>");
// Use the selector prefixed with its name.
Locator button = page.locator("tag=button");
// Combine it with built-in locators.
page.locator("tag=div").getByText("Click me").click();
// Can use it in any methods supporting selectors.
int buttonCount = (int) page.locator("tag=button").count();
browser.close();
参数
-
在选择器中用作前缀的名称,例如
{name: 'foo'}
启用foo=myselectorbody
选择器。只能包含[a-zA-Z0-9_]
字符。 -
评估为选择器引擎实例的脚本。该脚本在页面上下文中评估。
-
options
Selectors.RegisterOptions
(可选)
返回
setTestIdAttribute
新增于:v1.27定义用于Page.getByTestId()的自定义属性名。默认使用data-testid
。
用法
Selectors.setTestIdAttribute(attributeName);
参数