n1ro°
RU

Текст и данные · Инструкция

Как использовать bundledDependencies в package.json

Bundling нужен редко, но полезен, когда часть зависимостей должна ехать внутри одного package tarball, а не скачиваться

Редакция N1RO · Проверено

Короткий ответ

Поле `bundledDependencies` перечисляет зависимости, которые npm должен включить в публикуемый tarball вместе с пакетом. Проверьте актуальные условия по официальным источникам на дату 2026-09-18 и сверьте модель/версию устройства или сервиса перед действием.

Что делать

  1. 1. Проверьте необходимость bundling: Сначала убедитесь, что обычные dependencies и registry-доступ не решают задачу проще.
  2. 2. Добавьте зависимости: Перечислите package names в `bundledDependencies` в package.json.
  3. 3. Соберите tarball: Создайте package archive штатной командой npm.
  4. 4. Проверьте содержимое: Убедитесь, что нужные зависимости действительно попали внутрь и размер пакета остаётся разумным.

Когда bundling оправдан

Bundled dependencies полезны для автономного tarball, но увеличивают размер и переносят ответственность за обновление вложенных версий на publisher.

Важно

Bundling увеличивает размер tarball и усложняет обновление вложенных зависимостей; используйте его только при явной причине.

Как понять, что всё сработало

  • Собранный package tarball действительно содержит перечисленные bundled dependencies.
  • Размер tarball и лицензии bundled-кода проверены до публикации.

Что учитывать

Bundling увеличивает размер tarball и усложняет обновление вложенных зависимостей; используйте его только при явной причине.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. package.json). Пример и формулировки — редакция N1RO на 2026-09-18.