n1ro°
RU

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

Как пометить версию npm-пакета deprecated

Deprecate предупреждает пользователей, не удаляя опубликованный release.

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

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

Владелец пакета может выполнить `npm deprecate package@range "message"`; совпавшие версии останутся в registry, но install покажет warning.

Что делать

  1. Выберите точный package range.
  2. Сформулируйте сообщение с причиной и безопасной альтернативой.
  3. Выполните `npm deprecate <spec> "<message>"`.
  4. Проверьте registry metadata/warning.

Проверка результата

  • Warning отображается только для выбранного package@range, а версии остаются доступными в registry.
  • Текст deprecation указывает понятную причину/альтернативу и не затрагивает лишний диапазон.

Важно

Не используйте слишком широкий range: можно затронуть рабочие версии и prerelease.

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

Не используйте слишком широкий range: можно затронуть рабочие версии и prerelease.

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

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