Selectors

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

🌐 Selectors can be used to install custom selector engines. See extensibility for more information.

---

方法

🌐 Methods

RegisterAsync

Added before v1.9 selectors.RegisterAsync

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

🌐 Selectors must be registered before creating the page.

用法

注册根据标签名称查询元素的选择器引擎的示例：

🌐 An example of registering selector engine that queries elements based on a tag name:

using Microsoft.Playwright;

using var playwright = await Playwright.CreateAsync();
// Script that evaluates to a selector engine instance. The script is evaluated in the page context.
await playwright.Selectors.RegisterAsync("tag", new()
{
    Script = @"{
    // 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));
      }
    }"
});

await using var browser = await playwright.Chromium.LaunchAsync();
var page = await browser.NewPageAsync();
await page.SetContentAsync("<div><button>Click me</button></div>");
// Use the selector prefixed with its name.
var button = page.Locator("tag=button");
// Combine it with built-in locators.
await page.Locator("tag=div").GetByText("Click me").ClickAsync();
// Can use it in any methods supporting selectors.
int buttonCount = await page.Locator("tag=button").CountAsync();

参数

• name string#

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

• options SelectorsRegisterOptions? (optional)

  • ContentScript bool? (optional)#

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

  • Path string? (optional)#

    脚本会被计算为选择器引擎实例。该脚本在页面上下文中执行。

  • Script string? (optional)#

    脚本会被计算为选择器引擎实例。该脚本在页面上下文中执行。

返回

• void#

---

SetTestIdAttribute

Added in: v1.27 selectors.SetTestIdAttribute

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

🌐 Defines custom attribute name to be used in Page.GetByTestId(). data-testid is used by default.

用法

Selectors.SetTestIdAttribute(attributeName);

参数

• attributeName string#

  测试 id 属性名称。