À propos du versionnement sémantique

Pour que l’écosystème JavaScript reste sain, fiable et sécurisé, chaque fois que vous effectuez des mises à jour importantes d’un paquet npm dont vous êtes propriétaire, nous recommandons de publier une nouvelle version du paquet avec un numéro de version mis à jour dans le fichier package.json qui suit la spécification de versionnement sémantique. Suivre la spécification de versionnement sémantique aide les autres développeurs qui dépendent de votre code à comprendre l’étendue des changements dans une version donnée, et à ajuster leur propre code si nécessaire.

Incrémentation des versions sémantiques dans les paquets publiés

Pour aider les développeurs qui dépendent de votre code, nous recommandons de commencer la version de votre paquet à 1.0.0 et de l’incrémenter comme suit :

Utilisation du versionnage sémantique pour spécifier les types de mise à jour que votre paquet peut accepter

Vous pouvez spécifier les types de mise à jour que votre paquet peut accepter à partir des dépendances dans le fichier package.json de votre paquet.

Par exemple, pour spécifier les plages de versions acceptables jusqu’à 1.0.4, utilisez la syntaxe suivante :

• Versions de patch : 1.0 ou 1.0.x ou ~1.0.4
• Minor releases : 1 ou 1.x ou ^1.0.4
• Major releases : * ou x

Pour plus d’informations sur la syntaxe de versionnement sémantique, voir le calculateur npm semver.

Exemple

 "dependencies" : { 
 "my_dep" : "^1.0.0", 
 "another_dep" : "~2.2.0" 
 },