К содержимому
Войти

Frontend Road Map

📦 Размер бандла

Бандл — это JavaScript, который браузер скачивает, чтобы страница ожила. Каждый лишний килобайт в нём платится дважды: сетью и процессором телефона, причём процессором дороже. На собеседовании про бандл спрашивают почти всегда, когда речь заходит о производительности: как работает tree shaking, почему он не срабатывает и как ты узнаешь, что именно раздуло сборку

🧠 Почему килобайт JS дороже килобайта картинки

Картинку браузер скачивает и декодирует, часто вне главного потока. Пока она грузится, страница уже кликается. С JavaScript цепочка длиннее: скачать, распарсить, скомпилировать и выполнить, и выполнение идёт на главном потоке. Пока он занят твоим кодом, страница не отвечает на нажатия, это бьёт по INP (подробнее — на странице «Core Web Vitals»)

В статье web.dev про tree shaking есть наглядная схема: 170 КБ JavaScript против JPEG того же веса. Картинка декодируется быстро, скрипт требует в разы больше работы на каждый байт. Команда V8 в разборе «The cost of JavaScript» показала, что сам парсинг движки сильно ускорили и частично унесли в фоновые потоки. Главная цена теперь в скачивании и выполнении. И она зависит от устройства: на замерах Reddit средний телефон выполнял тот же JS в 3–4 раза дольше флагмана, а дешёвый Android — больше чем в 6 раз

Твой MacBook прощает лишние 300 КБ, а дешёвый телефон на 4G — нет. Смотри на бандл глазами самого слабого пользователя

Как бандл доходит до пользователя

Сборщик (Vite, Webpack, Turbopack) собирает твой код и зависимости в несколько файлов-чанков. Обычно это точка входа, общий чанк с библиотеками и отдельные чанки на маршруты. Сервер отдаёт их сжатыми Brotli или gzip, и по сети идёт в несколько раз меньше байт. Но браузер распаковывает файл и парсит полный размер, так что сжатие экономит сеть и никак не помогает процессору. Про сжатие и разбиение кода по маршрутам подробнее на странице «Быстрая загрузка», про хэши в именах чанков — на странице «HTTP-кэш и Service Worker»

РазмерЧто значитГде смотреть
Исходный (stat)Код до минификацииАнализатор бандла
Минифицированный (parsed)Столько браузер парсит и выполняетАнализатор, size-limit без сжатия
Сжатый (gzip, Brotli)Столько едет по сетиDevTools → Network, колонка Transferred

🌳 Tree shaking: как работает и почему ломается

Tree shaking — удаление кода, который никто не импортирует. Сборщик строит граф модулей: от точки входа идёт по import и помечает экспорты, которые реально используются. Всё, до чего не дошёл, в бандл не попадает

Работает это только на ES-модулях. import и export статичны: они стоят на верхнем уровне файла, и имена известны до запуска кода. Сборщик видит граф, не выполняя ни строчки. У CommonJS require — обычная функция, её можно вызвать в if, а module.exports можно собрать в цикле. Сборщик не может доказать, что половина модуля не нужна, и берёт его целиком

Дальше четыре причины, по которым tree shaking на практике не срабатывает

1. Зависимость в CommonJS

Классический пример — lodash. Он опубликован в CommonJS, и import { debounce } from 'lodash' тянет всю библиотеку. Вот три варианта, собранные в esbuild 0.28 с минификацией, lodash версии 4.18:

ИмпортМинифицированоgzip
import { debounce } from 'lodash'73 796 Б26 722 Б
import debounce from 'lodash/debounce'3 474 Б1 637 Б
import { debounce } from 'lodash-es'2 886 Б1 437 Б

Одна функция обошлась в 74 КБ, потому что сборщик не смог отрезать остальные три сотни. lodash-es — та же библиотека в ES-модулях, и там tree shaking работает. Ещё лучше проверить, не умеет ли нужное сам язык: structuredClone вместо cloneDeep, Object.groupBy вместо groupBy, Array.prototype.flat вместо flatten

Та же ловушка бывает и в собственном коде. Babel с @babel/preset-env в старых конфигах переписывал import в require, и tree shaking тихо выключался. Для сборки через бандлер ему ставят modules: false

2. Побочные эффекты

Побочный эффект — код, который что-то делает в момент импорта: регистрирует компонент в глобальном реестре, ставит полифил, подключает CSS. Если модуль с эффектом выкинуть, программа сломается. Поэтому сборщик осторожен: экспорт модуля не используется, но код верхнего уровня он оставит, потому что не уверен, что тот безвреден

Поле "sideEffects" в package.json — обещание автора пакета: «у моих файлов нет эффектов при импорте, выкидывай неиспользуемые смело». Значение false разрешает удалять любой неиспользуемый файл. Массив перечисляет файлы, которые трогать нельзя

{
  "name": "awesome-ui",
  "sideEffects": ["*.css", "./src/polyfills.js"]
}

Без *.css в этом списке сборщик честно выполнит обещание и выкинет import './Button.css': экспортов у файла нет, эффект ты сам объявил несуществующим. Кнопка отрисуется без стилей, и только в прод-сборке

3. Barrel-файлы

Barrel — файл index.ts, который реэкспортирует всё из папки: export * from './Button', export * from './Chart'. Импортировать удобно: import { Button } from '@/components'. Но сборщик обязан открыть каждый реэкспортированный файл, потому что любой из них может иметь побочный эффект

Пример, проверенный сборкой в esbuild: пакет ui с barrel на два файла, приложение берёт только Button, а chart.js при импорте пишет себя в глобальный реестр

JavaScript · barrel с побочным эффектом и что попадает в бандл

// node_modules/ui/index.js
export { Button } from './button.js'
export { Chart } from './chart.js'

// node_modules/ui/chart.js
globalThis.registry = (globalThis.registry || []).concat('chart')
export const Chart = () => 'chart'

// app.js
import { Button } from 'ui'
console.log(Button())

Без "sideEffects" в package.json пакета ui бандл такой:

// node_modules/ui/button.js
var Button = () => "button";

// node_modules/ui/chart.js
globalThis.registry = (globalThis.registry || []).concat("chart");

// app.js
console.log(Button());

С "sideEffects": false строка из chart.js исчезает, остаются Button и console.log

Сам Chart вырезан в обоих случаях, но его модуль выполнился. В реальном проекте на месте одной строки окажется импорт библиотеки графиков. В dev-режиме Vite barrel бьёт ещё и по скорости: браузер загружает каждый реэкспортированный файл, поэтому документация Vite советует импортировать из исходного файла

Next.js частично лечит это опцией experimental.optimizePackageImports: она переписывает импорт из пакета на импорт конкретных модулей. Для популярных библиотек (lucide-react, date-fns, lodash-es, @mui/material, react-icons и ещё два десятка) она включена по умолчанию

4. Динамический доступ

При вызове utils[name]() после import * as utils сборщик не знает, какое name придёт, и оставляет все экспорты. То же с export default { a, b, c }: из одного объекта поле не выкинешь

🔍 Как найти, что раздувает бандл

Не угадывай, смотри на карту. Анализатор рисует treemap: каждый модуль — прямоугольник, площадь пропорциональна размеру. Огромный прямоугольник moment/locale или вся lodash видны за секунду

  • Vite: плагин rollup-plugin-visualizer, функция visualizer() в plugins. После сборки появляется stats.html. Опции gzipSize и brotliSize добавят сжатые размеры, template переключит вид (treemap по умолчанию, sunburst, network). Без правки конфига — npx vite-bundle-visualizer, это обёртка над тем же плагином
  • Next.js с Turbopack: встроенный анализатор, команда next analyze, появилась в 16.1. Фильтрует модули по маршруту и по окружению (клиент или сервер) и показывает цепочку импортов: видно не только что тяжёлое, но и кто его притащил. next analyze --output пишет отчёт в .next/diagnostics/analyze, удобно сравнивать до и после
  • Next.js с Webpack (--webpack): плагин @next/bundle-analyzer, включается переменной ANALYZE=true при сборке

Новую зависимость до установки оцени на bundlephobia.com или pkg-size.dev: сколько она весит в бандле. Это дешевле, чем потом выпиливать библиотеку из сорока файлов

Частые тяжёлые зависимости

ЧтоПроблемаЧем заменить
momentПроект в режиме поддержки, объекты мутабельные, локали тянутся пачкойdate-fns (функции по одной), dayjs, нативный Intl.DateTimeFormat
lodashCommonJS, берётся целикомlodash-es, поштучный импорт lodash/debounce, нативные методы
Пак иконок через barrelСотни иконок ради трёхИмпорт по одной из пути конкретной иконки, optimizePackageImports в Next
Подсветка кода, Markdown, графики на клиентеБиблиотека едет в браузер ради статичного HTMLРендер на сервере (ниже)

Серверные компоненты

Код серверного компонента в клиентский бандл не попадает вовсе. В документации Next.js разобран пример с подсветкой кода: в клиентском компоненте prism-react-renderer целиком уезжает в браузер, а в серверном shiki отрабатывает на сервере, и клиент получает готовую разметку. Поэтому "use client" ставят на листья дерева, а не на страницу целиком. Подробнее — на странице «Серверные и клиентские компоненты» в модуле Next.js

🛠️ Бюджеты в CI

Бандл растёт не от одного решения, а от сорока мелких PR по 5 КБ, и каждый на ревью выглядит безобидно. Единственная защита — проверка, которая падает автоматически

size-limit — инструмент Андрея Ситника. Ты описываешь файлы и лимит, он собирает их, жмёт Brotli (это поведение по умолчанию) и сравнивает

{
  "scripts": {
    "size": "npm run build && size-limit"
  },
  "size-limit": [
    { "path": "dist/assets/index-*.js", "limit": "150 kB" },
    { "path": "dist/index.js", "import": "{ Button }", "limit": "5 kB" }
  ]
}

Первая запись задаёт бюджет приложения, вторая нужна библиотеке: поле import проверяет, сколько стоит импорт одного Button, и ловит сломанный tree shaking. Лимит можно задать и во времени ("500 ms"): плагин @size-limit/time запускает headless Chrome и меряет, сколько браузер компилирует и выполняет код. Для GitHub есть экшен andresz1/size-limit-action, он пишет размер в комментарий к PR и отклоняет его, если лимит превышен. В GitLab хватает отдельной джобы с npm run size

У Lighthouse CI похожая проверка на уровне страницы: ассерт resource-summary:script:size с максимумом в байтах валит сборку, если суммарный JS страницы вырос

⚠️ Где ошибаются

  • Меряют бандл в dev-режиме. Там нет минификации и tree shaking, цифры в разы больше и ничего не говорят. Анализируй только прод-сборку
  • Смотрят только на сжатый размер. 27 КБ по сети в примере с lodash выше — это 74 КБ кода, который телефон парсит и выполняет. В бюджете держи оба числа или хотя бы помни о разнице
  • Ставят "sideEffects": false в приложение не глядя. Глобальные стили, полифилы и модули, которые регистрируют себя при импорте, пропадут из прод-сборки, а в dev всё работает. Перечисляй такие файлы массивом
  • Верят, что именованный импорт сам по себе спасает. import { debounce } from 'lodash' выглядит как точечный, но из CommonJS-пакета приезжает вся библиотека
  • Добавляют бюджет, когда бандл уже 2 МБ. Срезать потом в разы тяжелее. Поставь size-limit с первого месяца проекта и поднимай лимит осознанно, в отдельном коммите с объяснением

🎯 Вопросы с собеседований

Что такое tree shaking и почему он может не сработать?

Это удаление неиспользуемого кода на этапе сборки. Сборщик строит граф по статичным import и export и выкидывает экспорты, до которых никто не дошёл. Не срабатывает, когда зависимость в CommonJS: require динамичен, и модуль берётся целиком, как lodash. Ещё когда у модуля есть побочные эффекты при импорте и сборщик боится их выкинуть, когда импорт идёт через barrel-файл и когда к экспортам обращаются динамически, через utils[name] или объект в export default. Иногда виноват Babel, который переписал import в require

Как понять, что раздувает бандл?

Собрать прод-версию и открыть анализатор: rollup-plugin-visualizer для Vite, next analyze для Next с Turbopack, @next/bundle-analyzer для Webpack. На treemap сразу видно самые большие модули. Дальше важно найти, кто их импортирует: анализатор Next показывает цепочку импортов, в остальных помогает поиск по коду. Частые находки — целая lodash, локали moment, все иконки пакета, тяжёлая библиотека в клиентском компоненте, которая могла работать на сервере

Почему 300 КБ JS хуже, чем 300 КБ картинки?

Картинку браузер только декодирует, обычно вне главного потока, и страница остаётся отзывчивой. JavaScript надо распарсить, скомпилировать и выполнить, а выполнение идёт на главном потоке и блокирует ввод. Вдобавок сжатые 300 КБ JS после распаковки в несколько раз больше. На слабом Android тот же скрипт выполняется в несколько раз дольше, чем на ноутбуке разработчика, поэтому JS бьёт по INP и времени до интерактивности сильнее любого другого ресурса того же веса

Зачем поле sideEffects в package.json?

Это подсказка сборщику, что файлы пакета не делают ничего при импорте, кроме экспорта. Тогда модуль, чьи экспорты не используются, можно выкинуть целиком, вместе с кодом верхнего уровня. false разрешает это для всех файлов, массив перечисляет исключения. Обычно туда пишут CSS и полифилы: без этого сборщик удалит import './styles.css', и стили пропадут только в проде

Почему barrel-файлы вредят?

index.ts с export * заставляет сборщик открыть все реэкспортированные модули, даже если нужен один. Если у какого-то из них есть побочный эффект или пакет не объявил sideEffects, его код попадёт в бандл. В dev-режиме Vite это ещё и сотни лишних запросов. Решение — импортировать из конкретного файла, а для внешних пакетов в Next включить optimizePackageImports

Как не дать бандлу расти незаметно?

Завести бюджет в CI. size-limit с лимитом на основные чанки падает в PR, который превысил порог, и показывает размер в комментарии. Для библиотеки дополнительно проверяют стоимость отдельного импорта через поле import. Плюс анализатор перед добавлением зависимости и правило поднимать лимит только осознанно, с объяснением в PR

📚 Что почитать