Playwright Frame y nueva ventana

Este capítulo explica cómo manejar iframes, diálogos emergentes, nuevas pestañas y el sistema de eventos de Playwright.


Operaciones con iframe

Playwright utilizaframeLocator()para localizar y operar elementos dentro de iframes.

page.frameLocator() para localizar iframe

Ejemplo

test('Operar elementos dentro del iframe', async ({ page }) => {
  await page.goto('https://www.example.com/iframe-demo');

  // Localizar el iframe y luego localizar elementos dentro de él
  const iframe = page.frameLocator('#my-iframe');

  // Operar elementos dentro del iframe
  await iframe.getByRole('button', { name: 'Enviar' }).click();
  await iframe.getByLabel('Nombre de usuario').fill('ejemplo_user');

  // Realizar aserciones dentro del iframe
  await expect(iframe.getByText('Operación exitosa')).toBeVisible();
});

Obtener todos los Frame

Ejemplo

// Obtener todos los frames de la página (incluidos el frame principal y los iframes)
const frames = page.frames();
console.log('La página tiene', frames.length, 'frames');

frames.forEach(frame => {
  console.log('Frame:', frame.name(), frame.url());
});

iframes anidados

El método de PlaywrightframeLocator()admite llamadas en cadena,

Ejemplo

// iframes anidados: externo → interno → elemento
const innerButton = page
  .frameLocator('#outer-frame')
  .frameLocator('#inner-frame')
  .getByRole('button', { name: 'Confirmar' });

await innerButton.click();

Manejo de diálogos (Dialogs)

Playwright tiene una estrategia de manejo predeterminada para los diálogos nativos del navegador (alert, confirm, prompt).

Comportamiento predeterminado

Playwright, por defecto,cierra automáticamentetodos los diálogos:

Tipo de diálogoComportamiento predeterminado
alert()Confirmar automáticamente (cerrar)
confirm()Confirmar automáticamente (devuelve true)
prompt()Confirmar automáticamente (devuelve cadena vacía)

Manejo personalizado de diálogos

Mediantepage.on('dialog')se pueden interceptar y manejar los diálogos de forma personalizada.

Ejemplo

test('Manejo personalizado de diálogos', async ({ page }) => {
  // Registrar el listener antes de que se lance el diálogo
  page.on('dialog', async dialog => {
    console.log('Tipo de diálogo:', dialog.type());
    console.log('Mensaje del diálogo:', dialog.message());

    if (dialog.type() === 'confirm') {
      // Cancelar el cuadro de confirmación
      await dialog.dismiss();
    } else if (dialog.type() === 'prompt') {
      // Ingresar contenido personalizado
      await dialog.accept('Contenido ingresado por EJEMPLO');
    } else {
      // Confirmar directamente otros tipos
      await dialog.accept();
    }
  });

  // Acción que lanza el diálogo
  await page.getByRole('button', { name: 'Eliminar' }).click();
});

Métodos del objeto Dialog

MétodoDescripción
dialog.accept(promptText?)Confirma el diálogo (puede pasar texto de entrada en prompt)
dialog.dismiss()Cancela el diálogo
dialog.message()Obtiene el mensaje de aviso del diálogo
dialog.type()Obtiene el tipo de diálogo:'alert' | 'confirm' | 'prompt' | 'beforeunload'

Nueva ventana y nueva pestaña

Al hacer clic en un enlace o botón que abre una nueva pestaña, Playwright ofrece varias formas de obtener la nueva página.

page.waitForEvent('popup') para esperar la ventana emergente

Ejemplo

test('Manejar nueva pestaña', async ({ page }) => {
  // Preparar la espera del evento de nueva página antes de hacer clic
  const popupPromise = page.waitForEvent('popup');

  // Hacer clic en el enlace que abre una nueva ventana
  await page.getByRole('link', { name: 'Abrir en nueva ventana' }).click();

  // Obtener la página recién abierta
  const popup = await popupPromise;

  // Operar en la nueva página
  await expect(popup).toHaveTitle(/EJEMPLO/);
  await popup.getByRole('button', { name: 'Aceptar' }).click();

  // Cerrar la nueva página
  await popup.close();
});

context.on('page') para escuchar nuevas páginas

Ejemplo

test('Escuchar todas las nuevas páginas del Context', async ({ context, page }) => {
  // Escuchar la creación de nuevas páginas en todo el Context
  context.on('page', async newPage => {
    console.log('Nueva página abierta:', newPage.url());
    // Esperar a que la nueva página termine de cargar
    await newPage.waitForLoadState();
    // Operar en la nueva página
  });

  await page.goto('https://www.example.com/');
  // Las acciones posteriores que abran nuevas ventanas activarán automáticamente el listener anterior
});

Sistema de eventos de Playwright

Los objetos Page y Context de Playwright son emisores de eventos; puedes escuchar varios eventos.

Eventos de página comunes

EventoMomento de activación
requestCuando la página realiza una solicitud de red
responseCuando se recibe una respuesta de red
dialogCuando aparece un diálogo alert/confirm/prompt
downloadCuando comienza la descarga de un archivo
popupCuando se abre una nueva página (ventana emergente/nueva pestaña)
consoleCuando la página emite un mensaje de consola
pageerrorCuando ocurre un error de JavaScript no capturado en la página
loadCuando la página termina de cargar
closeCuando la página se cierra

Métodos de escucha de eventos

Ejemplo

// Escucha continua
page.on('request', request => {
  console.log('Solicitud:', request.method(), request.url());
});

// Escucha única (se elimina automáticamente tras dispararse una vez)
page.once('dialog', dialog => {
  dialog.accept();
});

// Eliminar listener
const handler = (request) => { /* ... */ };
page.on('request', handler);
page.off('request', handler);
Otras extensiones