Accueil › JavaScript › npm et les dépendances
npm et les dépendances
Modules et outillageavance
{
"name": "mon-projet",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vite build",
"test": "vitest"
},
"dependencies": { "react": "^19.0.0" },
"devDependencies": { "vite": "^8.0.0" }
}
Les deux listes
dependencies: nécessaires à l'exécution. Elles partent en production.devDependencies: nécessaires au développement — compilateur, outil de test, bundler. Elles ne partent pas.
npm install react # dans dependencies
npm install -D vitest # dans devDependencies
Se tromper n'a aucun effet visible en développement, et alourdit l'image de production ou fait échouer un déploiement minimal.
Les plages de versions
| Écriture | Autorise | Exemple |
|---|---|---|
^18.3.0 |
mineures et correctifs | 18.9.2 oui, 19.0.0 non |
~18.3.0 |
correctifs seulement | 18.3.7 oui, 18.4.0 non |
18.3.0 |
rien | cette version exactement |
* |
tout | à ne jamais écrire |
Le verrou décide vraiment
package.json dit ce qu'on accepte ; package-lock.json dit ce qui est
installé, à la version exacte, dépendances indirectes comprises.
npm install # peut mettre à jour le verrou
npm ci # installe le verrou tel quel, ou échoue
Versionnez le verrou. Sans lui, votre machine et l'intégration continue installent des versions différentes, et un bogue apparaît d'un côté seulement.
Les termes à connaître
- package.json
Le manifeste du projet : son nom, ses scripts, ses dépendances et leurs plages de versions. C'est lui qu'on lit en arrivant sur un projet inconnu.
- Version sémantique
MAJEUR.MINEUR.CORRECTIF. Le majeur casse la compatibilité, le mineur ajoute, le correctif répare. C'est une convention, pas une garantie.- Fichier de verrouillage
package-lock.json: la version exacte de chaque paquet installé, dépendances indirectes comprises. À versionner, toujours.- npm ci
Installe exactement ce que le verrou décrit, sans le modifier. La commande à utiliser en intégration continue ;
npm installpeut, lui, mettre à jour.- devDependencies
Les dépendances nécessaires au développement seulement — compilateur, outil de test. Elles ne partent pas en production.
- Dépendance transitive
Un paquet installé parce qu'un autre en a besoin. On en a des centaines sans en avoir choisi aucune, et chacune est du code qu'on exécute.
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.