Playwright: фреймы и новые окна
В этой главе рассказывается, как работать с iframe, диалогами, новыми вкладками и системой событий Playwright.
Операции с iframe
Playwright используетframeLocator()для поиска и управления элементами внутри iframe.
page.frameLocator() для поиска iframe
Пример
await page.goto('https://www.example.com/iframe-demo');
// Найти iframe, затем найти элемент внутри него
const iframe = page.frameLocator('#my-iframe');
// Взаимодействовать с элементом внутри iframe
await iframe.getByRole('button', { name: 'Submit' }).click();
await iframe.getByLabel('Username').fill('example_user');
// Проверить внутри iframe
await expect(iframe.getByText('Operation successful')).toBeVisible();
});
Получить все фреймы
Пример
const frames = page.frames();
console.log('Страница содержит ', frames.length, ' фреймов');
frames.forEach(frame => {
console.log('Фрейм:', frame.name(), frame.url());
});
Вложенные iframe
PlaywrightframeLocator()поддерживает цепочки вызовов, позволяя глубокий доступ к вложенным iframe.
Пример
const innerButton = page
.frameLocator('#outer-frame')
.frameLocator('#inner-frame')
.getByRole('button', { name: 'Confirm' });
await innerButton.click();
Обработка диалогов
Playwright имеет стратегию обработки по умолчанию для нативных диалогов браузера (alert, confirm, prompt).
Поведение по умолчанию
Playwright по умолчаниюавтоматически отклоняетвсе диалоги:
| Тип диалога | Поведение по умолчанию |
|---|---|
alert() | Автоматически отклонить (закрыть) |
confirm() | Автоматически принять (возвращает true) |
prompt() | Автоматически принять (возвращает пустую строку) |
Пользовательская обработка диалогов
Использованиеpage.on('dialog')вы можете перехватывать и настраивать обработку диалогов.
Пример
// Зарегистрировать слушателя перед вызовом диалога
page.on('dialog', async dialog => {
console.log('Тип диалога:', dialog.type());
console.log('Сообщение диалога:', dialog.message());
if (dialog.type() === 'confirm') {
// Отменить диалог подтверждения
await dialog.dismiss();
} else if (dialog.type() === 'prompt') {
// Ввести пользовательское содержимое
await dialog.accept('Содержимое, введённое EXAMPLE');
} else {
// Для других типов просто принять
await dialog.accept();
}
});
// Операция, которая вызывает диалог
await page.getByRole('button', { name: 'Delete' }).click();
});
Методы объекта Dialog
| Метод | Описание |
|---|---|
dialog.accept(promptText?) | Принять диалог (можно передать текст ввода для prompt) |
dialog.dismiss() | Отклонить диалог |
dialog.message() | Получить сообщение диалога |
dialog.type() | Получить тип диалога:'alert' | 'confirm' | 'prompt' | 'beforeunload' |
Новые окна и новые вкладки
Когда при нажатии на ссылку или кнопку открывается новая вкладка, Playwright предоставляет несколько способов получить новую страницу.
page.waitForEvent('popup') для ожидания Popup
Пример
// Подготовка к ожиданию события новой страницы перед кликом
const popupPromise = page.waitForEvent('popup');
// Нажмите ссылку, которая открывает новое окно
await page.getByRole('link', { name: 'Open new window' }).click();
// Получить только что открытую страницу
const popup = await popupPromise;
// Работайте с новой страницей
await expect(popup).toHaveTitle(/EXAMPLE/);
await popup.getByRole('button', { name: 'OK' }).click();
// Закрыть новую страницу
await popup.close();
});
context.on('page') для прослушивания новых страниц
Пример
// Отслеживать создание новых страниц во всём контексте
context.on('page', async newPage => {
console.log('Открыта новая страница:', newPage.url());
// Дождитесь завершения загрузки новой страницы
await newPage.waitForLoadState();
// Работайте с новой страницей
});
await page.goto('https://www.example.com/');
// Последующие операции, открывающие новые окна, будут автоматически запускать указанный выше слушатель
});
Система событий Playwright
Объекты Page и Context в Playwright являются эмиттерами событий, и вы можете прослушивать различные события.
Общие события Page
| Event | Момент срабатывания |
|---|---|
request | Когда страница инициирует сетевой запрос |
response | Когда получен сетевой ответ |
dialog | Когда появляется диалоговое окно alert/confirm/prompt |
download | Когда начинается загрузка файла |
popup | Когда открывается новая страница (всплывающее окно/новая вкладка) |
console | Когда страница выводит сообщение в консоль |
pageerror | Когда на странице возникает неперехваченная ошибка JavaScript |
load | Когда страница завершает загрузку |
close | Когда страница закрывается |
Методы прослушивания событий
Пример
page.on('request', request => {
console.log('Request:', request.method(), request.url());
});
// Слушать один раз (автоматически удаляется после первого срабатывания)
page.once('dialog', dialog => {
dialog.accept();
});
// Удалить слушатель
const handler = (request) => { /* ... */ };
page.on('request', handler);
page.off('request', handler);