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-й |
Другие расширения