📦 Размер бандла
Бандл — это 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 |
lodash | CommonJS, берётся целиком | 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
📚 Что почитать
- Optimizing package bundling — анализатор Turbopack,
@next/bundle-analyzerи пример с переносом подсветки на сервер - Tree Shaking в документации webpack — подробный разбор
sideEffects, пропавшего CSS и аннотации/*#__PURE__*/ - Vite: Performance — почему barrel-файлы тормозят dev-сервер
- size-limit на GitHub — все опции конфига и готовый экшен для PR