Selectors

選取器可以用於安裝自訂的選取器引擎。請參閱擴充性以了解更多資訊。

---

方法

RegisterAsync

在 v1.9 之前新增 selectors.RegisterAsync

選取器必須在建立頁面之前註冊。

用法

註冊選取器引擎的範例，該引擎根據標籤名稱查詢元素

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? (選用)

  • ContentScript bool? (選用)#

    是否在隔離的 JavaScript 環境中執行此選取器引擎。此環境可以存取相同的 DOM，但不能存取框架腳本中的任何 JavaScript 物件。預設值為 false。請注意，當此引擎與其他已註冊的引擎一起使用時，不保證作為內容腳本執行。

  • Path string? (選用)#

    評估為選取器引擎實例的腳本。該腳本在頁面上下文中評估。

  • Script string? (選用)#

    評估為選取器引擎實例的腳本。該腳本在頁面上下文中評估。

傳回

• void#

---

SetTestIdAttribute

新增於：v1.27 selectors.SetTestIdAttribute

定義要在 Page.GetByTestId() 中使用的自訂屬性名稱。預設使用 data-testid。

用法

Selectors.SetTestIdAttribute(attributeName);

參數

• attributeName string#

  測試 ID 屬性名稱。