Расширяемость

Пользовательские механизмы селекторов

Playwright поддерживает пользовательские механизмы селекторов, регистрируемые с помощью Selectors.RegisterAsync().

Механизм селекторов должен иметь следующие свойства:

• Функция query для поиска первого элемента, соответствующего selector, относительно root.
• Функция queryAll для поиска всех элементов, соответствующих selector, относительно root.

По умолчанию механизм выполняется непосредственно в контексте JavaScript фрейма и, например, может вызывать функцию, определенную в приложении. Чтобы изолировать механизм от любого JavaScript в фрейме, но оставить доступ к DOM, зарегистрируйте механизм с опцией {contentScript: true}. Механизм контент-скрипта более безопасен, так как он защищен от любых изменений глобальных объектов, например, изменения методов Node.prototype. Все встроенные механизмы селекторов выполняются как контент-скрипты. Обратите внимание, что выполнение в качестве контент-скрипта не гарантируется, если механизм используется вместе с другими пользовательскими механизмами.

Селекторы должны быть зарегистрированы до создания страницы.

Пример регистрации механизма селекторов, который ищет элементы на основе имени тега:

// Зарегистрируйте механизм. Селекторы будут иметь префикс "tag=".
// Скрипт выполняется в контексте страницы.
await playwright.Selectors.Register("tag", new() {
  Script = @"
  // Должен оцениваться как экземпляр механизма селекторов.
  {
    // Возвращает первый элемент, соответствующий данному селектору в поддереве root.
    query(root, selector) {
      return root.querySelector(selector);
    },

    // Возвращает все элементы, соответствующие данному селектору в поддереве root.
    queryAll(root, selector) {
      return Array.from(root.querySelectorAll(selector));
    }
  }"
});

// Теперь мы можем использовать селекторы "tag=".
await page.Locator("tag=button").ClickAsync();

// Мы можем комбинировать его с встроенными локаторами.
await page.Locator("tag=div").GetByText("Click me").ClickAsync();