Семантическое управление версиями в npm

В этом руководстве вы узнаете о семантическом управлении версиями, чтобы указать версию для вашего пакета или установить указанную версию внешнего пакета.

Чтобы сделать экосистему JavaScript более надежной и безопасной, вам следует обновить номер версии в файле package.json в соответствии со спецификацией семантической версии:

major.minor.patch

Например:

4.17.1

В этой версии:

• major версия 4.
• minor версия 17.
• patch 1.

Для указанной версии вы должны увеличить:

• major версия, когда вы вносите изменения, несовместимые с предыдущей версией.
• minor версия, когда вы добавляете функцию обратной совместимости с предыдущей версией.
• Версия path, когда вы делаете исправления ошибок, обратно совместимые с предыдущей версией.

Если вы разрабатываете новый пакет, стартовая версия должна быть 1.0.0.

Когда вы делаете одно или несколько исправлений ошибок, обратно совместимых с версией 1.0.0, вы увеличиваете третью цифру 1.0.1.

Когда вы вводите новые обратно совместимые функции, вы увеличиваете среднюю цифру и сбрасываете третью цифру до нуля, например 1.1.0

Однако, когда вы вносите изменения, которые не имеют обратной совместимости с предыдущей версией, вы увеличиваете первую цифру и сбрасываете среднюю и последнюю цифры на ноль, например, 2.0.0.

Ниже объясняется, как рассчитать семантическое управление версиями.

1) Символ карата (он же шляпа) ^

Чтобы включить любую версию, которая больше, чем конкретная версия в том же основном диапазоне, вы используете символ карата ( ^ ):

^1.10.1

2) Символ тильды ~

Чтобы включить любую версию, которая старше определенной версии в том же дополнительном диапазоне, вы используете символ тильды (~):

~1.5.12

3) Операторы сравнения

Чтобы указать диапазон стабильных версий, вы используете один из операторов сравнения >, <, =, >=, <= :

>1.5

Или вы можете использовать дефис( - ), чтобы указать диапазон:

1.0.0 - 1.5.0

Обратите внимание, что с обеих сторон дефиса есть пробелы.

4) Предрелизные версии

Чтобы включить предварительную версию, например, альфа- и бета-версию, используйте тег предварительной версии:

1.0.0-alpha.1

Чтобы указать диапазон предварительной версии, вы используете сравнение, например > с тегом предварительной версии:

>=1.0.0-alpha.0 <1.0.5

5) Включение нескольких наборов версий

Чтобы включить несколько наборов версий, вы используете || комбинировать. Например:

 <1.2.0 || > 1.2.3

6) Использование символа x

Используйте символ x, чтобы указать любую версию. Например, 1.x соответствует любой версии с основной версией 1, такой как 1.0.0, 1.1.2, 1.10.20 и т. д.

Установка пакета с определенной версией

Чтобы установить пакет, используйте команду npm install :

npm install <package_name>

Чтобы установить пакет указанной версии, используйте знак @ :

npm install <package_name>@version

В следующем примере express -пакет устанавливается с версией 4.x :

npm install express@4.x

Он установит express -пакет с самой высокой версией 4.x, например, 4.17.1.