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).

ConceptoAnalogíaDescripción
Browser (instancia del navegador)Abre un programa de navegadorCosto alto, generalmente se crea solo una vez durante toda la ejecución de pruebas
Browser Context (contexto del navegador)Perfil independiente dentro del navegadorCosto bajo, uno por cada prueba
Page (pestaña)Una pestaña dentro del navegadorAbre 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 aisladoDescripción
CookiesCada Context tiene almacenamiento de cookies independiente
localStorageAlmacenamiento local completamente aislado
sessionStorageAlmacenamiento de sesión completamente aislado
IndexedDBBase de datos del navegador aislada
Caché (Cache)Caché HTTP aislada

Ejemplo

// La prueba A establece una Cookie
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

test('Usar el fixture context', async ({ context, page }) => {
  // 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

test('Dos usuarios operan de forma independiente', async ({ browser }) => {
  // 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.

El aislamiento de pruebas es el comportamiento predeterminado de Playwright; cadatest()prueba obtiene automáticamente un context independientepageycontext, sin necesidad de configuración adicional.

Otras extensiones