re:re:actable
Урок 045 минут чтения

Сеть в 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().

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам