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.0accepte 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.0accepte 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 contreditpackage.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.
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.