Скорость и мобильные

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

Иллюстрация к статье «Как задать бюджет производительности и проверить его»

Бюджет производительности — проверяемое ограничение маршрута и профиля, а не обещание одинаковой скорости всем пользователям.

Выберите маршрут и метрики

Выберите 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?

Войдите, чтобы оставить комментарий. Читать обсуждение могут все. Комментарии проходят автоматическую и редакционную проверку.