Селекторы

Селекторы можно использовать для установки пользовательских движков селекторов. Подробнее см. в разделе расширяемость.

Методы​

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

  Имя, используемое в селекторах в качестве префикса, например, {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. Обратите внимание: при использовании этого движка вместе с другими зарегистрированными движками запуск в качестве скрипта содержимого не гарантируется.

Возвращает

• Promise<void>

setTestIdAttribute​

Задаёт пользовательское имя атрибута, используемое в page.getByTestId(). По умолчанию используется data-testid.

Использование

selectors.setTestIdAttribute(attributeName);

Аргументы

• attributeName string

  Имя атрибута идентификатора теста. Чтобы выбирать элементы по любому из нескольких атрибутов, укажите их списком через запятую, например, "data-pw,data-ti".