Playwright: фреймы и новые окна

В этой главе рассказывается, как работать с iframe, диалогами, новыми вкладками и системой событий Playwright.


Операции с iframe

Playwright используетframeLocator()для поиска и управления элементами внутри iframe.

page.frameLocator() для поиска iframe

Пример

test('Взаимодействие с элементами в iframe', async ({ page }) => {
  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();
});

Получить все фреймы

Пример

// Получить все фреймы на странице (включая основной фрейм и iframe)
const frames = page.frames();
console.log('Страница содержит ', frames.length, ' фреймов');

frames.forEach(frame => {
  console.log('Фрейм:', frame.name(), frame.url());
});

Вложенные iframe

PlaywrightframeLocator()поддерживает цепочки вызовов, позволяя глубокий доступ к вложенным iframe.

Пример

// Вложенный 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')вы можете перехватывать и настраивать обработку диалогов.

Пример

test('Пользовательская обработка диалогов', async ({ page }) => {
  // Зарегистрировать слушателя перед вызовом диалога
  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

Пример

test('Handle new tab', async ({ page }) => {
  // Подготовка к ожиданию события новой страницы перед кликом
  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') для прослушивания новых страниц

Пример

test('Listen for all new pages in the Context', async ({ context, 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);
Другие расширения