Настройка Playwright: запись и воспроизведение каждого теста
playwrightProxy.before(page, testInfo, mode, options?)
Заголовок раздела «playwrightProxy.before(page, testInfo, mode, options?)»Вызывайте это в начале каждого теста (или в beforeEach / фикстуре страницы). Оно задаёт режим прокси для сессии и, если передан url, настраивает запись HAR для запросов на стороне браузера.
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/,});Шаблон url: совпадает с реальным внешним доменом, который вызывает браузер. В режиме record запросы идут на реальный API и сохраняются в файл .har. В режиме replay они отдаются из этого файла — без сети. Этот шаблон не указывает на прокси (localhost:8100).
Исключение — full-stack приложения: когда браузер тоже вызывает localhost:8100 (потому что фронтенд настроен с URL прокси как базой API), используйте в качестве шаблона /localhost:8100/. Тогда эти запросы браузера проходят к прокси, который записывает их в .mock.json теста и воспроизводит оттуда, поэтому на отсутствующий запрос приходит 404 от прокси, а не прерывание HAR (см. как воспроизведение сопоставляет запросы).
Имена файлов записей составляются из файла теста, заголовков describe и названия теста (users.spec.ts › create a user → users__create-a-user.mock.json / .har). Имя длиннее 120 байт обрезается и заканчивается хешем.
Тест без записи
Заголовок раздела «Тест без записи»В режиме воспроизведения before() выбрасывает исключение, если у теста нет записи, ещё до переключения прокси:
[test-proxy-recorder] This test has no recording: <recordingsDir>/users__create-a-user.mock.json does not exist. Record this test first.Запишите тест, а не пропускайте его: пропущенный тест отображается как пропущенный, а не упавший, поэтому отсутствующая запись остаётся незамеченной. hasRecording(testInfo) отвечает на тот же вопрос без исключения и использует те же имена файлов, что и воспроизведение.
Global teardown (рекомендуется)
Заголовок раздела «Global teardown (рекомендуется)»import { playwrightProxy } from 'test-proxy-recorder';
export default async function globalTeardown() { await playwrightProxy.teardown();}export default defineConfig({ globalTeardown: './e2e/global-teardown.ts',});teardown() сбрасывает прокси в transparent и выполняет проход маскирования HAR. Переключение в transparent сохраняет и завершает все сессии записи. Не вызывайте его в хуке afterAll для каждого теста при fullyParallel — почему это ломает параллельные воспроизведение и запись, см. в FAQ.
Файлы записей
Заголовок раздела «Файлы записей»e2e/recordings/ my-test.mock.json # server-side (proxy) — SSR fetches my-test.har # client-side (HAR) — browser fetches