Configuración de Playwright: graba y reproduce cada prueba
playwrightProxy.before(page, testInfo, mode, options?)
Sección titulada «playwrightProxy.before(page, testInfo, mode, options?)»Llama a esto al inicio de cada prueba (o en un beforeEach / fixture de página). Establece el modo del proxy para la sesión y, si se proporciona url, configura la grabación HAR para peticiones del lado del navegador.
await playwrightProxy.before(page, testInfo, 'replay', { // url: pattern for browser-side requests to record/replay via HAR. // // Use the ACTUAL external API domain — not the proxy URL. // Examples: // /api\.example\.com/ — your own API // /x\.com/ — record all x.com browser traffic (Chrome extension tests) // /cognito-.*amazonaws\.com/ — 3rd-party auth url: /api\.example\.com/,});Patrón url: coincide con el dominio externo real que llama el navegador. En modo record las peticiones van a la API real y se guardan en un archivo .har. En modo replay se sirven desde ese archivo — sin red. Este patrón no apunta al proxy (localhost:8100).
Excepción — apps full-stack: cuando el navegador también llama a localhost:8100 (porque el frontend está configurado con la URL del proxy como su base de API), usa /localhost:8100/ como patrón. Esas peticiones del navegador pasan entonces al proxy, que las graba en el .mock.json de la prueba y las reproduce desde él, así que una que falte recibe el 404 del proxy en lugar de que HAR la aborte (mira cómo se emparejan las peticiones al reproducir).
Los nombres de archivo de grabación salen del archivo de prueba, de los títulos de describe y del título de la prueba (users.spec.ts › create a user → users__create-a-user.mock.json / .har). Un nombre de más de 120 bytes se recorta y termina en un hash.
Una prueba sin grabación
Sección titulada «Una prueba sin grabación»En replay, before() lanza un error cuando la prueba no tiene grabación, antes de cambiar el modo del proxy:
[test-proxy-recorder] This test has no recording: <recordingsDir>/users__create-a-user.mock.json does not exist. Record this test first.Graba la prueba en lugar de omitirla: una prueba omitida se reporta como omitida, no como fallida, así que una grabación que falta pasa desapercibida. hasRecording(testInfo) responde a la misma pregunta sin lanzar un error, con los mismos nombres de archivo que la reproducción.
Teardown global (recomendado)
Sección titulada «Teardown global (recomendado)»import { playwrightProxy } from 'test-proxy-recorder';
export default async function globalTeardown() { await playwrightProxy.teardown();}export default defineConfig({ globalTeardown: './e2e/global-teardown.ts',});teardown() reinicia el proxy a transparent y ejecuta la pasada de enmascaramiento de HAR. El cambio a transparent guarda y termina todas las sesiones de grabación. No lo llames en un hook afterAll por prueba bajo fullyParallel — mira en las preguntas frecuentes por qué eso rompe la reproducción y la grabación en paralelo.
Archivos de grabación
Sección titulada «Archivos de grabación»e2e/recordings/ my-test.mock.json # server-side (proxy) — SSR fetches my-test.har # client-side (HAR) — browser fetches