API класса Locator в Playwright

Locator — это объект локатора Playwright, предоставляющий цепочную фильтрацию, операции и утверждения.


Методы операций Locator

МетодОписание
locator.click(options?)Клик по элементу
locator.dblclick(options?)Двойной клик по элементу
locator.hover(options?)Наведение мыши
locator.fill(value, options?)Очистить и заполнить текст
locator.type(text, options?)Вводить посимвольно
locator.clear(options?)Очистить поле ввода
locator.check(options?)Отметить чекбокс
locator.uncheck(options?)Снять флажок
locator.setChecked(checked, options?)Установить состояние чекбокса
locator.selectOption(values, options?)Выбрать опцию выпадающего списка
locator.setInputFiles(files, options?)Задать файл для загрузки
locator.dragTo(target, options?)Перетащить к целевому элементу
locator.press(key, options?)Нажать клавишу
locator.screenshot(options?)Скриншот элемента
locator.scrollIntoViewIfNeeded(options?)Прокрутить в область видимости

Цепочная фильтрация локаторов

МетодОписание
locator.first()Получить первый подходящий элемент
locator.last()Получить последний подходящий элемент
locator.nth(index)Получить n-й элемент (с отсчетом от 0)
locator.filter(options?)Фильтровать по условиям (hasText, has, hasNot)
locator.locator(selector)Продолжить поиск среди совпадающих результатов
locator.getByRole(role, options?)Искать по роли среди совпадающих результатов
locator.getByText(text)Искать по тексту среди совпадающих результатов
locator.getByLabel(text)Искать по метке среди совпадающих результатов
locator.and(locator)Логическое И (1.63+)
locator.or(locator)Логическое ИЛИ (1.63+)

Получение информации о локаторе

МетодОписание
locator.textContent(options?)Получить текстовое содержимое
locator.innerHTML(options?)Получить innerHTML
locator.innerText(options?)Получить видимый текст
locator.inputValue(options?)Получить значение input
locator.getAttribute(name)Получить значение атрибута
locator.count()Получить количество совпадений
locator.isVisible(options?)Видимый
locator.isHidden(options?)Скрытый
locator.isEnabled(options?)Включенный
locator.isDisabled(options?)Отключенный
locator.isEditable(options?)Редактируемый
locator.isChecked(options?)Проверен ли
locator.boundingBox(options?)Получить позицию и размер элемента

Выполнение JS в Locator

МетодОписание
locator.evaluate(fn, arg?, options?)Выполнить JS в контексте элемента
locator.evaluateAll(fn, arg?)Выполнить JS для всех подходящих элементов
locator.evaluateHandle(fn, arg?, options?)Выполнить JS и вернуть JSHandle

LocatorAssertions (автоматическая повторная попытка)

Метод проверкиОписание
expect(locator).toBeAttached()Элемент находится в DOM
expect(locator).toBeChecked()Checked
expect(locator).toBeDisabled()Disabled
expect(locator).toBeEditable()Редактируемый
expect(locator).toBeEmpty()Содержимое пустое
expect(locator).toBeEnabled()Enabled
expect(locator).toBeFocused()Имеет фокус
expect(locator).toBeHidden()Элемент не виден
expect(locator).toBeInViewport()Элемент находится в области просмотра
expect(locator).toBeVisible()Элемент видим
expect(locator).toContainText(text)Содержит текст
expect(locator).toHaveAccessibleDescription(desc)Имеет доступное описание
expect(locator).toHaveAccessibleName(name)Имеет доступное имя
expect(locator).toHaveAttribute(name, value?)Имеет атрибут DOM
expect(locator).toHaveClass(className)Имеет имя CSS-класса
expect(locator).toHaveCount(count)Имеет указанное количество
expect(locator).toHaveCSS(name, value)Имеет значение CSS-свойства
expect(locator).toHaveId(id)Имеет ID
expect(locator).toHaveText(text)Текстовое содержимое совпадает
expect(locator).toHaveValue(value)Значение ввода совпадает
expect(locator).toHaveValues(values)Совпадение нескольких значений (множественный выбор)
expect(locator).toHaveScreenshot(options?)Сравнение скриншотов элементов

Класс FrameLocator

МетодОписание
frameLocator.getByRole(role, options?)Поиск по роли
frameLocator.getByText(text)Поиск по тексту
frameLocator.getByLabel(text)Поиск по label
frameLocator.getByPlaceholder(text)Поиск по placeholder
frameLocator.getByTestId(id)Поиск по testId
frameLocator.locator(selector)Поиск по CSS/XPath
frameLocator.frameLocator(selector)Поиск вложенных iframe
frameLocator.first()Получить первый
frameLocator.last()Получить последний
frameLocator.nth(index)Получить n-й
Другие расширения