Formations — 1 037 leçons en français

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

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 install peut, 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.

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.