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
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
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
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álogo | Comportamiento 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
// 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étodo | Descripció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
// 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
// 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
| Evento | Momento de activación |
|---|---|
request | Cuando la página realiza una solicitud de red |
response | Cuando se recibe una respuesta de red |
dialog | Cuando aparece un diálogo alert/confirm/prompt |
download | Cuando comienza la descarga de un archivo |
popup | Cuando se abre una nueva página (ventana emergente/nueva pestaña) |
console | Cuando la página emite un mensaje de consola |
pageerror | Cuando ocurre un error de JavaScript no capturado en la página |
load | Cuando la página termina de cargar |
close | Cuando la página se cierra |
Métodos de escucha de eventos
Ejemplo
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);