PassFront
  1. PassFront
  2. База знаний
  3. Менеджеры пакетов

Что такое phantom dependencies и как с ними справляется pnpm?

Менеджеры пакетов

Phantom dependency — пакет, который вы импортируете, не объявив в package.json, потому что он случайно лежит в node_modules.

// package.json не объявляет lodash, но он лежит в node_modules из-за hoisting
import debounce from 'lodash/debounce'; // в pnpm это упадёт сразу

Откуда берётся

npm и yarn «поднимают» (hoisting) вложенные пакеты в корневой node_modules. Если ваша зависимость тянет lodash, он окажется рядом, и import _ from 'lodash' сработает, хотя вы его не просили.

Чем опасно

  • Когда зависимость уберёт lodash или обновится, ваш код сломается без видимой причины.
  • На другой машине или в CI структура может отличаться.

Что делает pnpm

В node_modules лежат только прямые зависимости проекта. Остальные хранятся во вложенной структуре и недоступны напрямую. Попытка импортировать необъявленный пакет сразу падает с ошибкой.

Как защититься в npm

Включайте правило ESLint import/no-extraneous-dependencies: оно ругается на импорт пакета, которого нет в package.json.

Коротко для собеседования

Phantom dependency работает случайно из-за hoisting. pnpm делает такие импорты ошибкой, в npm помогает линтер.

Подробнее: pnpm — Motivation

Другие вопросы раздела