Тестирование производительности: 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.