Playwright

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

Имена файлов записей выводятся из имён тестов ("create a user" → create-a-user.mock.json / .har).

Global teardown (рекомендуется)

e2e/global-teardown.ts

import { playwrightProxy } from 'test-proxy-recorder';

export default async function globalTeardown() {
  await playwrightProxy.teardown();
}

playwright.config.ts

export default defineConfig({
  globalTeardown: './e2e/global-teardown.ts',
});

teardown() сбрасывает прокси в transparent и выполняет проход редактирования HAR. Не вызывайте его в хуке afterAll для каждого теста при fullyParallel — почему это ломает параллельное воспроизведение, см. в FAQ.

Файлы записей

e2e/recordings/
  my-test.mock.json   # server-side (proxy) — SSR fetches
  my-test.har         # client-side (HAR)   — browser fetches