Перейти к содержимому

Настройка Playwright: запись и воспроизведение каждого теста

Вызывайте это в начале каждого теста (или в 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) отвечает на тот же вопрос без исключения и использует те же имена файлов, что и воспроизведение.

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. Переключение в transparent сохраняет и завершает все сессии записи. Не вызывайте его в хуке afterAll для каждого теста при fullyParallel — почему это ломает параллельные воспроизведение и запись, см. в FAQ.

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