✅ NPM : Gérer les packages JavaScript

Table des matières

Utilisation de package.json
Installation des dépendances
Définir les versions de package
Mettre à jour les packages
Gestion du cache

Présentation du MNP

Qu'est-ce que le NPM ?NPM (Node Package Manager) est un gestionnaire de packages pour JavaScript, c'est la valeur par défaut pour node.js. Lorsque vous installez le nœud, NPM est également installé. Et qu'est-ce que cela signifie? Eh bien, grâce à NPM, nous pouvons installer et gérer les packages de nos applications.

Lorsque nous utilisons Node.js, nous devons rapidement installer de nouveaux modules (bibliothèques) car Node, étant un système fortement modulaire, est pratiquement vide. Ainsi, pour la plupart des opérations, nous devrons installer des modules supplémentaires. Cette opération se fait très facilement avec l'outil NPM.

Comment installer Node.js ?Pour installer Node.js, la première chose à faire est d'entrer sur le site officiel :

https://nodejs.org/

Et téléchargez le programme d'installation en fonction de notre système d'exploitation.

AGRANDIR

Lors du téléchargement du fichier d'installation, il suffit de double-cliquer dessus et de suivre les instructions de l'assistant d'installation de Node.js.

Une fois installée pour les utilisateurs Windows, la console node.js sera accessible depuis la barre de lancement, comme illustré dans l'image suivante :

AGRANDIR

Les utilisateurs de Mac devront ouvrir le terminal de leur système d'exploitation comme indiqué dans l'image suivante :

AGRANDIR

Pour vérifier qu'il est correctement installé, nous exécutons la commande suivante dans notre terminal :

 ne donnent pas

(Windows / Linux / Terminal OS X Console)

Nous poussons Entrer et nous entrons dans la ligne suivante :

 Console.log ('Node.js installé avec succès');

(Windows / Linux / Terminal OS X Console)

En appuyant Entrer, il nous montrera le message "Node.js installé avec succès". Pour voir la liste des commandes autorisées par node.js, on saisit la commande .aider comme le montre l'image suivante :

Pour voir le Version NPM installée, nous exécutons la commande suivante :

 npm -v

Ce qui se traduira par ce qui suit :

Directeur chargé d'emballage
Le Gestionnaire de paquets NPM, est un peu différent des autres gestionnaires de paquets que nous connaissons peut-être, car il les installe localement dans les projets. C'est-à-dire que lorsqu'un module est téléchargé, il est ajouté à un projet local, qui est celui qui l'aura disponible pour l'inclure. Bien qu'il existe également la possibilité d'installer les packages globalement sur notre système.

Commencer un nouveau projet

Lorsque nous commençons un nouveau projet en utilisant node.js, il est nécessaire de créer un fichier appelé package.json. C'est une sorte de manifeste qui contient à son tour la liste de toutes les dépendances que votre projet utilisera.

Utilisation de package.json

La meilleure façon de gérer les packages installés localement est de créer un fichier package.json, cela nous permet de :

Documentez les packages utilisés par notre projet.
Spécifiez quelle version de package spécifique notre projet utilisera.
Cela nous permet de partager facilement nos dépendances avec d'autres développeurs.

Exigences:

Un fichier package.json doit avoir au moins :

1. Nom :

Le tout en minuscule.
Un mot sans espace.
Le tiret et le trait de soulignement sont autorisés.

2. Version :

Exemple de package.json :

 {"Name": "project_package", "Version": "1.0.0"}

Si vous souhaitez générer un nouveau package.json, il y a 2 façons de le faire :

1. Chargez un package.json par défaut : Depuis la console, nous exécutons la ligne de commande suivante.

 npm init --oui

Ce qui se traduira par ce qui suit :

Pour modifier cette configuration, nous ouvrons simplement le fichier créé avec un éditeur de texte et modifions les attributs que nous voulons.

2. Créez un package.json avec l'assistant : Dans la console, nous exécutons la commande suivante.

 initialisation npm

L'assistant vous demandera ce que vous souhaitez ajouter à chaque attribut, résultant en ce qui suit :

Installation des dépendances

Sur le site https://www.npmjs.com/ vous pouvez trouver des centaines de projets; qui se positionnent selon différents critères (nombre de téléchargements, popularité…). À partir de la page Web, c'est le moyen le plus rapide, mais NPM dispose également d'un paramètre de recherche pour rechercher des packages. Pour ce faire, vous devez exécuter la ligne de commande suivante :

Installation locale
Une fois le fichier défini package.json, vous pouvez y ajouter les dépendances et ajouter une liste de tout ce dont vous avez besoin :

 "dependencies": {"express": "*", "grunt": "*", "bower": "*"}

Qui devrait être comme suit :

Installez les packages répertoriés dans package.jsonPour installer les packages listés dans package.json et leurs dépendances, vous devez vous trouver dans le répertoire où se trouve ledit fichier et exécuter la ligne de commande suivante :

 npm installer

Installer des packagesVous pouvez aussi installer de nouveaux packages et les enregistrer à partir du terminal, en exécutant ce qui suit :

 npm install --save new_package_name

Désinstaller des packagesDésinstaller le paquet et supprimez-le de package.json:

 npm uninstall --save package_name

Installer le package directement depuis un dépôt Git

 npm installer git : //github.com/blured/mipaquete.git

Installer une version spécifique d'un package

 npm installe un [email protected]

Il est important de noter que cette méthode d'installation locale signifie que vos fichiers seront stockés et disponibles uniquement dans votre répertoire de projet.

Installation globale
Une autre façon d'installer des packages est de le faire globalement. Ceci est couramment utilisé pour les packages qui fournissent des fonctionnalités à partir de la ligne de commande telles que grunt, bower, yeoman, entre autres.

Prenons par exemple le Paquet JSHint, qui est un analyseur de code JavaScript qui nous permet de montrer les points dans lesquels votre code n'est pas conforme à certaines règles établies de "clean code". Pour l'installer globalement, nous exécutons le commande d'installation en ajoutant le attribut -g et avec privilège root (pour les utilisateurs Mac et Linux).

 sudo npm install -g jshint

 npm install -g jshint

Pour confirmer son installation, exécutez simplement sa commande pour évaluer les erreurs dans certains fichiers JavaScript. Comme notre installation était globale, depuis n'importe quel endroit, nous pouvons exécuter Jshint, indiquant le chemin où se trouve notre fichier JavaScript. Exemple:

 projet jshint \ MiApp \ www \ js \ index.js

Entraînant une erreur dans notre fichier JavaScript.

Pour connaître le dossier dans lequel sont stockées toutes ces bibliothèques à portée globale, on peut utiliser le commande de préfixe et du marqueur global -g, de la manière suivante:

 préfixe npm -g

Dans un terminal OS X, cela donnera le résultat suivant :

Dans le CInvite de commande Windows le chemin est affiché, ayant comme seule variable, le nom du dossier de l'utilisateur qui a fait l'installation. Dans ce cas, ce serait "Zhock":

Sous Windows, NodeJS n'a pas le dossier précédent défini comme global pour l'inclusion de ses bibliothèques via require. Donc, si nous essayons d'inclure une bibliothèque globale, nous obtiendrons l'erreur "Error: Cannot find module".

Pour le résoudre, nous devrons définir la variable système NODE_PATH, en lui donnant la valeur du chemin global de NPM et en ajoutant le dossier \ node_modules \ à la fin.

Comme nous pouvons le voir, dans Windows 7, le chemin d'installation global de NPM est :

 C:\Users\USER\AppData\Roaming\npm\

La valeur de NODE_PATH sera donc :

 C:\Users\USER\AppData\Roaming\npm\node_modules\

Ou ce qui est pareil :

 % APPDATA% \ npm \ node_modules \

AGRANDIR

Gestion des dépendances
NPM vous permet de gérer les dépendances de vos projets et les versions dont vous avez besoin. Comme on le sait, les projets open source évoluent activement et changent fréquemment de version. Le package.json il peut être configuré pour contrôler ces types de changements.

Les numéros de version ils contiennent normalement 3 éléments :

Version majeure lorsqu'elle rompt avec les fonctionnalités précédentes, par exemple : 2.0.0
Version mineure avec de nouvelles fonctionnalités qui ne cassent pas celles existantes, par exemple : 1.1.0
Patch publié avec des corrections de bogues et d'autres modifications mineures, par exemple 1.0.1

Définir les versions de package

Disons que vous commencez à développer avec certaines versions de packages. Vous pouvez les mettre à jour tout en conservant la compatibilité en spécifiant la plage de modifications acceptées.

 "dependencies": {"Package1": "1.0.0", // accepte uniquement la version 1.0.0 "container2": "1.0.x", // toute version de correctif dans la version 1.0 "Package3": "* ", / / dernière version," Package4 "est déconseillé :"> = 1.0.0 ", // modifications après 1.0.0" package5 ":" = 1.8.0 = 1.1.0 <2.0.0 "package8": "latest" , // dernière version tag name "package9": "", // identique à * c'est-à-dire dernière version "packageX": "= 2.3.1 = 2.5.2 <3.0.0" }

NoterSi vous n'êtes pas sûr de la version à utiliser, ajoutez le caractère générique * et exécutez la commande npm update -save, que nous verrons plus loin dans ce didacticiel.

Commander:

 mise à jour npm --save

Mettre à jour les packages

Pour voir tous les packages installés localement, utilisez la commande ls et ajoutez l'attribut -l pour une brève description. Pour afficher les packages installés globalement, ajoutez l'attribut -g.

 npm ls -l

Pour vérifier quel package peut être mis à jour localement et globalement, exécutez la commande suivante :

 npm obsolète npm obsolète -g --depth = 0

Pour amener localement un package vers une version supérieure à la version actuelle, exécutez la commande suivante :

 mise à jour npm

Pour le faire globalement, ajoutez le attribut -g

Gestion du cache

Lorsque NPM installe un package, il en conserve une copie pour la prochaine fois que vous souhaitez installer le package sans avoir besoin d'une connexion Internet. Ces copies sont stockées par défaut dans le répertoire suivant :

 Posix (Linux, Os X…) : ~/.npm Windows :% AppData% / npm-cache

Si vous voulez voir dans quel répertoire le cache NPM est stocké, exécutez simplement la ligne de commande suivante :

 npm config obtenir le cache

Ce répertoire est généralement rempli d'anciens packages que nous n'utilisons plus, c'est pourquoi il est recommandé de nettoyer périodiquement avec la ligne de commande suivante :