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

Тестирование производительности: Lighthouse CI, бюджеты и регрессии

На этой странице
Кратко

Производительность деградирует незаметно: каждый PR добавляет «всего 10 КБ» или один лишний запрос, а через полгода LCP на мобильных вырос вдвое. Поэтому её проверяют автоматически в CI, как функциональность. Инструменты: бюджеты бандла (size-limit, Next.js-анализ бандла) — PR падает, если JS ключевой страницы превысил лимит; Lighthouse CI — лабораторный прогон ключевых страниц с порогами по метрикам и категориям (performance, accessibility, SEO, best practices); тесты взаимодействий в Playwright — замер длинных задач, INP-подобных метрик через PerformanceObserver, числа запросов и отсутствия водопадов; бенчмарки чистых функций (vitest bench). Лабораторные замеры шумные, поэтому: несколько прогонов и медиана, стабильное окружение, пороги с запасом, сравнение с базовой веткой. И главное — лабораторные тесты не заменяют RUM: реальные Core Web Vitals пользователей (p75) смотрят в мониторинге, а тесты в CI ловят регрессии до релиза.

Вопрос

Как автоматически проверять производительность фронтенда и не допускать её деградации? Что такое бюджеты производительности и Lighthouse CI?

Уровни проверок

PR ──▶ size-limit: JS главной ≤ 170 КБ (gzip)          ← быстро, стабильно, ловит большинство регрессий
   ──▶ Lighthouse CI: LCP, TBT, CLS на 5 ключевых страницах (медиана 3 прогонов)
   ──▶ Playwright: нет длинных задач > 200 мс при открытии фильтров; ≤ 1 запроса при переходе
Прод ─▶ RUM: p75 LCP/INP/CLS по реальным пользователям, алерты

Бюджет бандла: size-limit

// .size-limit.json
[
  { "name": "Главная (клиентский JS)", "path": ".next/static/chunks/app/page-*.js", "limit": "60 KB" },
  { "name": "Общий JS всех страниц", "path": ".next/static/chunks/*.js", "limit": "180 KB" },
  { "name": "UI-кит: Button", "path": "packages/ui/dist/index.js", "import": "{ Button }", "limit": "3 KB" }
]
pnpm size-limit             # локально
# CI: andresz1/size-limit-action комментирует PR: «+4.2 KB (+2.3%)»

Для библиотек import-проверка показывает реальный размер с tree-shaking: «импорт Button тянет весь кит» сразу виден.

Lighthouse CI

// lighthouserc.js
module.exports = {
  ci: {
    collect: {
      startServerCommand: "pnpm start",
      url: ["http://localhost:3000/", "http://localhost:3000/catalog/kettles", "http://localhost:3000/product/aqua-kettle"],
      numberOfRuns: 3,                                   // медиана — меньше шума
      settings: { preset: "desktop" },                   // или мобильная эмуляция по умолчанию
    },
    assert: {
      assertions: {
        "categories:performance": ["error", { minScore: 0.9 }],
        "categories:accessibility": ["error", { minScore: 0.95 }],
        "largest-contentful-paint": ["error", { maxNumericValue: 2500 }],
        "cumulative-layout-shift": ["error", { maxNumericValue: 0.1 }],
        "total-blocking-time": ["warn", { maxNumericValue: 200 }],
        "resource-summary:script:size": ["error", { maxNumericValue: 250_000 }],
      },
    },
    upload: { target: "temporary-public-storage" },      // или свой LHCI-сервер для истории
  },
};

Lighthouse не измеряет INP (нужно реальное взаимодействие); в лаборатории его косвенный показатель — TBT (Total Blocking Time).

Производительность в Playwright

test("открытие фильтров не блокирует главный поток надолго", async ({ page }) => {
  await page.goto("/catalog/kettles");
 
  await page.evaluate(() => {
    (window as any).__longTasks = [];
    new PerformanceObserver((list) => {
      for (const e of list.getEntries()) (window as any).__longTasks.push(e.duration);
    }).observe({ type: "longtask", buffered: false });
  });
 
  await page.getByRole("button", { name: "Фильтры" }).click();
  await expect(page.getByRole("dialog", { name: "Фильтры" })).toBeVisible();
 
  const longTasks: number[] = await page.evaluate(() => (window as any).__longTasks);
  expect(Math.max(0, ...longTasks)).toBeLessThan(200);
});
 
test("переход в карточку товара не делает водопад запросов", async ({ page }) => {
  await page.goto("/catalog/kettles");
  const apiCalls: string[] = [];
  page.on("request", (r) => r.url().includes("/api/") && apiCalls.push(r.url()));
  await page.getByRole("link", { name: "Электрический чайник Aqua" }).click();
  await expect(page.getByRole("heading", { level: 1 })).toHaveText("Электрический чайник Aqua");
  expect(apiCalls.length).toBeLessThanOrEqual(1);
});
 
test("LCP главной страницы", async ({ page }) => {
  await page.goto("/");
  const lcp = await page.evaluate(() => new Promise<number>((resolve) => {
    new PerformanceObserver((list) => {
      const entries = list.getEntries();
      resolve(entries[entries.length - 1].startTime);
    }).observe({ type: "largest-contentful-paint", buffered: true });
  }));
  expect(lcp).toBeLessThan(2500);
});

Такие тесты нестабильны на общих CI-машинах — ставь пороги с запасом и запускай в отдельном job, а не в каждом e2e.

Бенчмарки функций

// sort.bench.ts
import { bench, describe } from "vitest";
 
describe("сортировка 10 000 товаров", () => {
  const products = buildProducts(10_000);
  bench("sortByPriceStable", () => { sortByPriceStable(products); });
  bench("lodash sortBy", () => { sortBy(products, "price"); });
});
pnpm vitest bench

Тесты рендеринга React

  • React Profiler API (<Profiler onRender>) в тесте: проверить, что ввод в поле поиска не перерендеривает весь список (полезно для критичных мест).
  • React Compiler снимает большую часть ручной мемоизации — регрессии ловятся скорее через TBT/INP, чем через подсчёт рендеров.
  • Подсчёт рендеров — деталь реализации; используй только как защиту для известных проблемных мест.

Как уменьшить шум

Источник шумаРешение
Разная загрузка CI-машинНесколько прогонов + медиана; выделенный runner
Сторонние скриптыБлокировать в тестах производительности
Холодный кэш/стартПрогрев перед замером
Абсолютные пороги на шумных метрикахСравнение с main (изменение в %)

Что важно помнить

  • Производительность проверяют в CI, чтобы ловить регрессии до релиза.
  • Бюджет бандла — самый стабильный и дешёвый сигнал.
  • Lighthouse CI: несколько прогонов, пороги по LCP, CLS, TBT и категориям.
  • Playwright: длинные задачи, число запросов, метрики через PerformanceObserver.
  • Лабораторные тесты не заменяют RUM.

Мини-шпаргалка

  • size-limit + .size-limit.json + комментарий в PR.
  • lighthouserc.js: collect.url, numberOfRuns, assert.assertions.
  • PerformanceObserver({ type: "longtask" | "largest-contentful-paint" }).
  • vitest bench.

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

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

Поиск

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