Справочник по API класса Page в Playwright
Page — наиболее часто используемый класс в Playwright, предоставляющий все методы для взаимодействия со страницей.
Методы навигации
| Метод | Описание |
|---|
page.goto(url, options?) | Перейти по URL |
page.goBack(options?) | Назад |
page.goForward(options?) | Вперёд |
page.reload(options?) | Перезагрузить страницу |
Методы локаторов
| Метод | Описание |
|---|
page.getByRole(role, options?) | Поиск по ARIA-роли |
page.getByText(text, options?) | Поиск по текстовому содержимому |
page.getByLabel(text, options?) | Поиск по связанной метке |
page.getByPlaceholder(text) | Поиск по placeholder |
page.getByAltText(text) | Поиск по атрибуту alt изображения |
page.getByTitle(text) | Поиск по атрибуту title |
page.getByTestId(id) | Поиск по data-testid |
page.locator(selector) | Локатор CSS / XPath |
page.frameLocator(selector) | Локатор iframe |
Получение свойств страницы
| Метод | Описание |
|---|
page.title() | Получить заголовок страницы |
page.url() | Получить текущий URL |
page.content() | Получить полное HTML-содержимое |
page.viewportSize() | Получить размер области просмотра |
Скриншоты и PDF
| Метод | Описание |
|---|
page.screenshot(options?) | Скриншот страницы |
page.pdf(options?) | Сгенерировать PDF (только Chromium) |
page.video() | Получить объект видео |
Клавиатура и мышь
| Свойство | Описание |
|---|
page.keyboard | Объект клавиатуры |
page.mouse | Объект мыши |
page.touchscreen | Объект сенсорного экрана |
Выполнение JS
| Метод | Описание |
|---|
page.evaluate(fn, arg?) | Выполнить JS в контексте страницы |
page.evaluateHandle(fn, arg?) | Выполнить JS и вернуть JSHandle |
page.addInitScript(script) | Внедрить скрипт инициализации |
page.addStyleTag(options?) | Добавить тег style |
page.addScriptTag(options?) | Добавить тег script |
page.exposeFunction(name, fn) | Предоставить функцию странице |
Методы ожидания
| Метод | Описание |
|---|
page.waitForURL(url, options?) | Ожидание изменения URL |
page.waitForLoadState(state?) | Ожидание состояния загрузки |
page.waitForTimeout(ms) | Фиксированное ожидание |
page.waitForEvent(event, options?) | Ожидание события |
page.waitForResponse(urlOrPredicate, options?) | Ожидание сетевого ответа |
page.waitForRequest(urlOrPredicate, options?) | Ожидание сетевого запроса |
Сеть и маршрутизация
| Метод | Описание |
|---|
page.route(url, handler) | Перехватывать сетевые запросы |
page.unroute(url, handler?) | Отменить перехват |
page.routeFromHAR(har, options?) | Воспроизвести сеть из HAR-файла |
Events
| Event | Описание |
|---|
page.on('request', handler) | Прослушивать запрос |
page.on('response', handler) | Прослушивать ответ |
page.on('dialog', handler) | Прослушивать всплывающее окно |
page.on('download', handler) | Прослушивать загрузку |
page.on('popup', handler) | Прослушивать страницу всплывающего окна |
page.on('console', handler) | Прослушивать консоль |
page.on('pageerror', handler) | Прослушивать ошибку страницы |
page.on('close', handler) | Прослушивать закрытие страницы |
Связано с фреймами
| Метод | Описание |
|---|
page.mainFrame() | Получить основной фрейм |
page.frames() | Получить все фреймы |
Другие
| Метод | Описание |
|---|
page.context() | Получить BrowserContext-владельца |
page.close() | Закрыть страницу |
page.pause() | Приостановить выполнение (для отладки) |
page.setViewportSize(size) | Установить размер области просмотра |
page.bringToFront() | Вывести страницу на передний план |
page.emulateMedia(options?) | Эмулировать медиафункции |
page.clock | Объект Clock (имитация времени) |
PageAssertions (автоматически повторяющиеся проверки)
| Методы проверок | Описание |
|---|
expect(page).toHaveTitle(title) | Проверка заголовка страницы |
expect(page).toHaveURL(url) | Проверка URL страницы |
expect(page).toHaveScreenshot(options?) | Сравнение скриншотов страницы |
Другие расширения