Contents
- 1. Qu’est-ce que NPM ?
- 2. Installation de Node.js et NPM
- 3. Initialiser un nouveau projet avec NPM
- 4. Installer des packages avec NPM
- 5. Gestion des dépendances avec package.json
- 6. Utilisation de packages installés
- 7. Mettre à jour les packages
- 8. Supprimer les packages inutilisés
- 9. Les scripts npm
- 10. Publier un package sur npm
- 11. Outils complémentaires
1. Qu’est-ce que NPM ?
NPM (Node Package Manager) est un gestionnaire de packages pour l’écosystème Node.js. Il est principalement utilisé pour installer, gérer et partager des packages (modules) JavaScript réutilisables qui peuvent être utilisés dans des projets Node.js ou des projets Web front-end.
2. Installation de Node.js et NPM
Avant d’utiliser NPM, vous devez installer Node.js, car NPM est livré avec Node.js. Pour installer Node.js, rendez-vous sur le site officiel de Node.js (https://nodejs.org/) et téléchargez la version adaptée à votre système d’exploitation. Une fois installé, NPM sera également disponible sur votre machine.
Pour vérifier si Node.js et NPM sont correctement installés, ouvrez une invite de commande ou un terminal et tapez les commandes suivantes :
node -v npm -v
Ces commandes afficheront respectivement la version de Node.js et NPM installée sur votre système.
3. Initialiser un nouveau projet avec NPM
Avant de commencer à utiliser NPM, vous devez initialiser un nouveau projet. Dans un dossier vide, ouvrez une invite de commande ou un terminal et exécutez la commande suivante pour initialiser un nouveau projet :
npm init
Suivez les instructions pour remplir les détails du projet tels que le nom, la version, la description, l’auteur, etc. Une fois terminé, un fichier package.json sera créé dans votre répertoire de projet. Ce fichier contient les métadonnées de votre projet ainsi que les dépendances dont il a besoin.
4. Installer des packages avec NPM
NPM vous permet d’installer des packages pour votre projet en utilisant la commande npm install. Vous pouvez spécifier les packages que vous souhaitez installer en les séparant par un espace. Par exemple, pour installer le package lodash, utilisez la commande suivante :
npm install lodash
Si vous voulez installer une dépendance et l’ajouter au fichier package.json, utilisez l’option --save ou -S. Par exemple :
npm install lodash --save
Pour installer un package en tant que dépendance de développement, utilisez l’option --save-dev ou -D. Ces dépendances ne sont nécessaires que pendant le développement et ne seront pas incluses lors du déploiement du projet en production :
npm install jest --save-dev
5. Gestion des dépendances avec package.json
Le fichier package.json est crucial pour la gestion des dépendances dans votre projet. Il liste toutes les dépendances dont votre projet a besoin, y compris les versions spécifiques, les dépendances de développement et les scripts personnalisés.
Pour installer toutes les dépendances répertoriées dans le fichier package.json, exécutez simplement la commande suivante dans le répertoire de votre projet :
npm install
Pour ajouter une nouvelle dépendance et l’inscrire dans package.json, utilisez la commande npm install package_name --save pour une dépendance standard ou npm install package_name --save-dev pour une dépendance de développement, comme mentionné précédemment.
6. Utilisation de packages installés
Une fois que vous avez installé des packages, vous pouvez les utiliser dans votre code. Pour inclure un package dans votre projet, utilisez la fonction require pour Node.js ou les modules spécifiques au navigateur (ES modules) pour les projets front-end.
Par exemple, pour utiliser le package lodash, vous pouvez faire ce qui suit dans votre code :
// Pour Node.js
const _ = require('lodash');
// Pour les modules spécifiques au navigateur (ES modules)
import _ from 'lodash';
7. Mettre à jour les packages
Les packages JavaScript évoluent fréquemment, et il est essentiel de maintenir vos dépendances à jour pour bénéficier des dernières fonctionnalités et correctifs de sécurité. Pour mettre à jour un package spécifique, utilisez la commande suivante :
npm update package_name
Si vous souhaitez mettre à jour tous les packages vers les versions les plus récentes, exécutez simplement :
npm update
8. Supprimer les packages inutilisés
Pour supprimer un package dont vous n’avez plus besoin, utilisez la commande npm uninstall ou npm remove suivi du nom du package :
npm uninstall package_name
9. Les scripts npm
Dans le fichier package.json, vous pouvez définir des scripts personnalisés pour automatiser certaines tâches. Par exemple, vous pouvez définir un script pour exécuter vos tests, démarrer le serveur de développement, compiler des fichiers, etc. Pour exécuter un script défini, utilisez la commande suivante :
npm run script_name
10. Publier un package sur npm
Si vous avez créé un package JavaScript réutilisable que vous souhaitez partager avec la communauté, vous pouvez le publier sur npm. Pour publier un package, vous devez d’abord vous connecter à votre compte npm à l’aide de la commande suivante :
npm login
Suivez les instructions pour vous connecter à votre compte. Une fois connecté, utilisez la commande suivante pour publier votre package :
npm publish
Assurez-vous d’avoir un nom de package unique pour éviter les conflits.
11. Outils complémentaires
En plus de NPM, il existe d’autres outils populaires pour la gestion des packages, tels que Yarn, qui offre des fonctionnalités supplémentaires. Vous pouvez choisir celui qui convient le mieux à vos besoins.
En conclusion, NPM est un outil puissant pour la gestion des dépendances JavaScript. Il vous permet d’installer, de mettre à jour, de gérer et de partager facilement des packages pour vos projets Node.js ou Web. Avec une compréhension solide de NPM et de ses fonctionnalités, vous pouvez développer des projets JavaScript plus efficacement et utiliser des solutions prêtes à l’emploi pour accélérer votre développement.
