Formations — 1 037 leçons en français

Accueil › Node.js › Versions, verrou et reproductibilité

Versions, verrou et reproductibilité

Modules et npmdebutant

Une version npm s'écrit majeur.mineur.correctif, et un package.json déclare presque toujours une plage, pas une version.

Ce que les plages autorisent

Écriture Accepte S'arrête avant
5.1.0 5.1.0 seule —
~5.1.0 les correctifs 5.2.0
^5.1.0 mineures et correctifs 6.0.0
^0.4.2 les correctifs seulement 0.5.0
* n'importe quoi —

Le cas 0.x est la source d'erreur la plus fréquente : la règle de ^ est « ne change pas le premier chiffre non nul ». Sous la version 1, ce chiffre est le mineur, et ^ se comporte donc comme ~.

Le verrou dit ce qui est vraiment installé

"node_modules/express": {
  "version": "5.1.0",
  "resolved": "https://registry.npmjs.org/express/-/express-5.1.0.tgz",
  "integrity": "sha512-…"
}

package.json déclare une intention, package-lock.json enregistre le résultat : chaque paquet, transitives comprises, avec son empreinte. Il se versionne dans le dépôt, sans exception.

Deux commandes, deux contrats

npm install     # peut mettre à jour le verrou pour satisfaire package.json
npm ci          # supprime node_modules et installe le verrou, tel quel

En intégration continue et dans une image de conteneur, c'est npm ci. Il échoue quand le verrou et package.json se contredisent, ce qui transforme une dérive silencieuse en erreur visible.

Les termes à connaître

Version sémantique

majeur.mineur.correctif. Majeur casse, mineur ajoute, correctif répare — une promesse de l'auteur, pas une garantie du registre.

Plage `^`

^5.1.0 accepte toute version jusqu'à 6.0.0 exclue. Le défaut de npm, et donc ce que subit le projet sans y penser.

Plage `~`

~5.1.0 accepte les correctifs seulement, jusqu'à 5.2.0 exclue. Plus étroit, plus prévisible.

Fichier de verrou

package-lock.json : l'arbre complet des versions réellement installées, avec leur empreinte. Il se versionne, toujours.

`npm ci`

Installe exactement le verrou, après avoir supprimé node_modules. Échoue si le verrou contredit package.json.

Dépendance transitive

Une dépendance de vos dépendances. Elle est dans le verrou, elle s'exécute chez vous, et vous ne l'avez pas choisie.

`integrity`

L'empreinte du tarball enregistrée dans le verrou. Elle garantit le même contenu d'octets, pas l'absence de code malveillant.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.