Сеть в Playwright: page.route, HAR и API-тесты
На этой странице
Playwright умеет работать с сетью тремя способами. Перехват запросов браузера — page.route(url, handler): подменить ответ (route.fulfill), изменить настоящий ответ (route.fetch + fulfill), заблокировать (route.abort) или пропустить (route.continue). Так проверяют редкие состояния, которые трудно вызвать на реальном бэкенде: ошибка 500, пустой список, медленный ответ, офлайн. HAR-файлы — записать реальные ответы один раз (routeFromHAR с update: true) и воспроизводить их в тестах. API-тесты — фикстура request отправляет HTTP-запросы без браузера: быстро создать тестовые данные, проверить эндпоинты и права, сделать вход. Важное ограничение: page.route видит только запросы из браузера; запросы, которые делает сервер Next.js (RSC, Server Actions), он не перехватывает. Не превращай e2e в тесты с полностью замоканной сетью — тогда это интеграционные тесты в браузере, а главная ценность e2e (проверка настоящей связки фронтенда и бэкенда) теряется. Моки — для отдельных сложных состояний.
Вопрос
Как в Playwright перехватывать и подменять сетевые запросы, эмулировать ошибки и медленную сеть, и как писать API-тесты?
Подмена ответа
test("показывает пустое состояние, если заказов нет", async ({ page }) => {
await page.route("**/api/orders*", (route) => route.fulfill({ json: [] }));
await page.goto("/account/orders");
await expect(page.getByText("У вас пока нет заказов")).toBeVisible();
});
test("показывает ошибку и даёт повторить", async ({ page }) => {
let calls = 0;
await page.route("**/api/recommendations", (route) =>
++calls === 1
? route.fulfill({ status: 500, json: { message: "boom" } })
: route.fallback(), // второй раз — настоящий запрос
);
await page.goto("/");
await expect(page.getByText("Рекомендации временно недоступны")).toBeVisible();
await page.getByRole("button", { name: "Повторить" }).click();
await expect(page.getByRole("region", { name: "Рекомендации" }).getByRole("article").first()).toBeVisible();
});Изменение настоящего ответа
await page.route("**/api/products/aqua-kettle", async (route) => {
const response = await route.fetch(); // настоящий запрос
const json = await response.json();
await route.fulfill({ response, json: { ...json, stock: 0 } }); // только поле stock
});
await page.goto("/product/aqua-kettle");
await expect(page.getByRole("button", { name: "В корзину" })).toBeDisabled();
await expect(page.getByText("Нет в наличии")).toBeVisible();Блокировка и медленная сеть
// Не грузить аналитику, чаты поддержки и тяжёлые сторонние скрипты
await page.route(/(google-analytics|hotjar|intercom)/, (route) => route.abort());
// Медленный ответ — проверить скелетон и отсутствие двойной отправки
await page.route("**/api/orders", async (route) => {
await new Promise((r) => setTimeout(r, 2000)); // задержка внутри мока допустима
await route.continue();
});
// Офлайн
await page.context().setOffline(true);
await page.getByRole("button", { name: "Сохранить" }).click();
await expect(page.getByText("Нет соединения. Изменения сохранятся, когда сеть появится")).toBeVisible();
await page.context().setOffline(false);Для тонкой эмуляции скорости (throttling) в Chromium используют CDP-сессию (Network.emulateNetworkConditions).
Проверка запроса
const requestPromise = page.waitForRequest((req) => req.url().endsWith("/api/orders") && req.method() === "POST");
await page.getByRole("button", { name: "Оформить" }).click();
const request = await requestPromise;
expect(request.postDataJSON()).toMatchObject({ deliveryMethod: "courier", items: [{ sku: "aqua-kettle", qty: 1 }] });HAR: запись и воспроизведение
// Записать ответы стороннего API (один раз): update: true
await page.routeFromHAR("e2e/hars/catalog.har", { url: "**/partner-api/**", update: true });
// В тестах — воспроизводить; неизвестные запросы — ошибка или настоящая сеть
await page.routeFromHAR("e2e/hars/catalog.har", { url: "**/partner-api/**", notFound: "abort" });HAR удобен для нестабильных или платных внешних API, но устаревает — обновляй его осознанно и проверяй дифф.
API-тесты
import { test, expect } from "@playwright/test";
test.describe("API заказов", () => {
test("гость получает 401", async ({ playwright, baseURL }) => {
const guest = await playwright.request.newContext({ baseURL });
expect((await guest.get("/api/orders")).status()).toBe(401);
await guest.dispose();
});
test("пользователь не видит чужой заказ", async ({ request }) => { // request с storageState проекта
const res = await request.get("/api/orders/order-of-another-user");
expect(res.status()).toBe(404);
});
test("создание заказа валидирует тело", async ({ request }) => {
const res = await request.post("/api/orders", { data: { items: [] } });
expect(res.status()).toBe(422);
expect(await res.json()).toMatchObject({ errors: { items: expect.any(Array) } });
});
});request использует cookie из storageState проекта, поэтому API-тесты работают от имени нужной роли.
Смешанный сценарий: данные через API, проверка через UI
test("созданный через API заказ виден в истории", async ({ request, page }) => {
const created = await request.post("/api/orders", { data: { items: [{ sku: "aqua-kettle", qty: 1 }] } });
const { id } = await created.json();
await page.goto("/account/orders");
await expect(page.getByRole("row", { name: new RegExp(`Заказ №${id}`) })).toBeVisible();
});Подготовка через API сокращает тест в разы и убирает зависимость от UI, который проверяется в другом месте.
Когда мокать в e2e
| ✓ Мокать | ✗ Не мокать |
|---|---|
| Редкие ошибки (500, таймаут) для проверки UI | Основной сценарий — он должен идти через настоящий бэкенд |
| Внешние сервисы: аналитика, карты, чаты | Собственный API в «счастливом пути» |
| Нестабильные/платные сторонние API (HAR) | Всё подряд ради скорости — это уже не e2e |
| Состояния, которые трудно воспроизвести (нет товара на складе) |
Что важно помнить
page.route+fulfill/fetch/abort/continue/fallback.- Перехватываются только запросы браузера, не серверные запросы Next.js.
setOffline, задержки в моках — для офлайна и медленной сети.request— быстрые API-тесты и подготовка данных.- Моки в e2e — точечно, основной сценарий — на настоящем бэкенде.
Мини-шпаргалка
page.route("**/api/x", r => r.fulfill({ status, json })).route.fetch()+route.fulfill({ response, json }).page.waitForRequest(...),request.postDataJSON().page.routeFromHAR(file, { update }).request.get/post(...),playwright.request.newContext().