Playwright Test Isolation y Browser Context
Este capítulo introduce el mecanismo de aislamiento de pruebas de Playwright y el concepto de Browser Context, que es un diseño clave para garantizar pruebas estables y fiables.
¿Qué es el aislamiento de pruebas?
El aislamiento de pruebas se refiere a que cada caso de prueba se ejecuta encompletamente independientedel entorno, sin afectarse entre sí.
En Playwright, cada prueba obtiene automáticamente unBrowser Contextcontexto de navegador independiente (Browser Context).
¿Qué es Browser Context?
Browser Context es equivalente a unperfil de navegador completamente nuevo.。
Crear un Context es como abrir una ventana de navegador completamente nueva, con sus propias cookies, localStorage y sessionStorage, pero con un costo extremadamente bajo (del orden de milisegundos).
| Concepto | Analogía | Descripción |
|---|---|---|
| Browser (instancia del navegador) | Abre un programa de navegador | Costo alto, generalmente se crea solo una vez durante toda la ejecución de pruebas |
| Browser Context (contexto del navegador) | Perfil independiente dentro del navegador | Costo bajo, uno por cada prueba |
| Page (pestaña) | Una pestaña dentro del navegador | Abre páginas dentro del Context |
En cada prueba, elpageycontextcontexto es completamente nuevo, por lo que si una prueba modifica localStorage o cookies, no afecta a otras pruebas.
Contenido aislado del Context
Cada Browser Context aísla completamente lo siguiente:
| Elemento aislado | Descripción |
|---|---|
| Cookies | Cada Context tiene almacenamiento de cookies independiente |
| localStorage | Almacenamiento local completamente aislado |
| sessionStorage | Almacenamiento de sesión completamente aislado |
| IndexedDB | Base de datos del navegador aislada |
| Caché (Cache) | Caché HTTP aislada |
Ejemplo
test('Prueba A', async ({ page }) => {
await page.goto('https://www.example.com/');
// Establecer Cookie (solo válida en el Context actual)
await page.context().addCookies([{
name: 'ejemplo_session',
value: 'abc123',
domain: 'www.example.com',
path: '/',
}]);
// Las operaciones posteriores usan esa Cookie
});
// La prueba B recibe un Context completamente nuevo, sin la Cookie establecida por la prueba A
test('Prueba B', async ({ page }) => {
await page.goto('https://www.example.com/');
// context().cookies() devuelve un array vacío
const cookies = await page.context().cookies();
console.log(cookies); // []
});
Uso del fixture de context
Además delpagepage, la función de prueba también puede acceder alcontextfixture context para realizar operaciones a nivel de Context.
Ejemplo
// Establecer permisos a nivel de Context
await context.grantPermissions(['geolocation']);
await context.setGeolocation({ latitude: 39.9, longitude: 116.4 });
// Interceptar la red a nivel de Context
await context.route('**/*.{png,jpg,jpeg}', route => route.abort());
// page está en el mismo context, por lo que hereda la configuración anterior
await page.goto('https://www.example.com/');
});
Escenario de múltiples Contexts
Cuando necesitas simular múltiples usuarios independientes en la misma prueba, puedes crear Contexts manualmente.
Ejemplo
// Crear Contexts independientes para los dos usuarios
const userAContext = await browser.newContext();
const userBContext = await browser.newContext();
// Las páginas de los dos usuarios están completamente aisladas
const pageA = await userAContext.newPage();
const pageB = await userBContext.newPage();
await pageA.goto('https://www.example.com/login');
await pageB.goto('https://www.example.com/login');
// El usuario A inicia sesión
await pageA.getByLabel('usuario').fill('user_a');
await pageA.getByLabel('contraseña').fill('password_a');
await pageA.getByRole('button', { name: 'Iniciar sesión' }).click();
// El usuario B inicia sesión (cada uno tiene su propia Cookie/Sesión, sin afectarse mutuamente)
await pageB.getByLabel('usuario').fill('user_b');
await pageB.getByLabel('contraseña').fill('password_b');
await pageB.getByRole('button', { name: 'Iniciar sesión' }).click();
// Limpiar
await userAContext.close();
await userBContext.close();
});
Beneficios del aislamiento de pruebas
1. Reproducibilidad
Cada prueba comienza desde el mismo estado inicial, y los resultados son consistentes sin importar el orden de ejecución.
2. Previene fallos en cascada
Que la prueba A falle no provocará que la prueba B también falle; cada prueba se puede depurar de forma independiente.
3. Soporta ejecución en paralelo
Como las pruebas son completamente independientes, Playwright puede ejecutarlas en paralelo de forma segura en múltiples workers.
Otras extensionesEl aislamiento de pruebas es el comportamiento predeterminado de Playwright; cada
test()prueba obtiene automáticamente un context independientepageycontext, sin necesidad de configuración adicional.