Скорость и мобильные
Как задать бюджет производительности и проверить его

Бюджет производительности — проверяемое ограничение маршрута и профиля, а не обещание одинаковой скорости всем пользователям.
Выберите маршрут и метрики
Выберите URL, mobile или desktop профиль Lighthouse и baseline commit. Ограничьте total transfer, JavaScript и число ресурсов отдельно. Учебный пример: /blog/a, mobile, total 700 KB, scripts 250 KB. Это пример для конкретного профиля, а не универсальная норма. Lab запуск контролируемый и не описывает опыт всех пользователей.
Зафиксируйте устройство, throttling, версию браузера и дату. Повторите запуск три раза и сохраняйте диапазон, но используйте один профиль для сравнения до и после.
Запишите budget.json
Создайте budget.json как массив объектов: [{"path":"/*","resourceSizes":[{"resourceType":"script","budget":250},{"resourceType":"total","budget":700}],"resourceCounts":[{"resourceType":"script","budget":15}]}]. Запускайте npx lighthouse https://example.test/blog/a --budget-path=budget.json --output=json --output-path=./artifacts/lh.json. Сверьте поддерживаемые типы и единицы с установленной версией Lighthouse.
Проверьте, что JSON читается установленной версией Lighthouse, а бюджет лежит в репозитории рядом со сборкой. Изменение лимита требует объяснения и ревью, иначе регрессия станет незаметной.
Проверьте в Lighthouse CI
Для автоматического отказа сборки настройте Lighthouse CI. В lighthouserc.json задайте {"ci":{"collect":{"url":["https://example.test/blog/a"],"numberOfRuns":3},"assert":{"budgetsFile":"budget.json"}}}. Замените учебный URL доступным тестовым адресом. После установки зафиксированной версии @lhci/cli выполните lhci collect, затем lhci assert. Именно проверка assert возвращает ошибку при нарушении бюджета: успешное завершение обычного Lighthouse CLI означает завершённый замер, а не соблюдение лимитов.
Сохраните отчёты и вывод проверки. budgetsFile не совмещают с другими параметрами assert в одной конфигурации. Альтернатива — правила resource-summary:script:size и resource-summary:script:count; в них размер задаётся в байтах, тогда как budget.json использует килобайты. Отдельно проверьте меню, поиск и форму: бюджет не подтверждает работоспособность интерфейса.
После исправления сравните waterfall и функциональные сценарии с baseline. Если лимит превышен только из-за ожидаемого ресурса, приложите решение владельца и новый расчёт, а не отключайте assertion.
Разберите превышение
Откройте Coverage и Network, найдите новый импорт, third-party script или chunk. Используйте treeshaking, code splitting и отложенную загрузку после проверки функций. Не увеличивайте budget без причины; изменение лимита запишите рядом с diff сборки и новым baseline.
Проверьте третий party по одному: аналитика, чат и виджет могут загружаться только после действия пользователя. Удаляйте компонент лишь после проверки его владельцем и fallback.
При ручной проверке в браузере не смешивайте переданные байты с размером распакованного файла: MDN определяет transferSize как объём переданного ресурса вместе с заголовками. Нулевое значение бывает связано с кешем или ограничением доступа к данным чужого домена, поэтому его нельзя автоматически считать отсутствием сетевой нагрузки.
Сопоставьте lab и field
Успешный lab budget не доказывает полевое улучшение, INP или опыт медленных устройств. После релиза сравните field data отдельно. Проверьте representative URLs и сохраните commit, версию Lighthouse, профиль, отчёт и результат CI, чтобы повторить проверку.
Field отчёты зависят от реальных устройств, сети и доли пользователей. Одна удачная лабораторная цифра не позволяет утверждать рост скорости для всего сайта.
Сохраните исходный JSON отчёта и журнал CI. Другой сотрудник должен повторить маршрут без ручной подмены результата.
Первоисточники
FAQ
Частые вопросы
Что задаёт budget.json?
Лимиты размеров и числа ресурсов для маршрута и профиля.
Что делает CI assertion?
Завершает сборку ошибкой при превышении бюджета.
Доказывает ли budget полевое улучшение?
Нет, lab и field измеряют разные условия.
Проверьте себя
Вопрос 1 из 2. Результат увидите только вы.
Обсуждение
Как остановить сборку при превышении performance budget?
Войдите, чтобы оставить комментарий. Читать обсуждение могут все. Комментарии проходят автоматическую и редакционную проверку.