npm Tutoriel
Commencer avec npm
Recherche…
Remarques
npm est le gestionnaire de paquets par défaut pour Node.js. Il est écrit entièrement en JavaScript et permet d'installer et de distribuer principalement des modules JavaScript sur le registre. Les packages sont traités au format CommonJS et sont reconnaissables à la présence d'un fichier package.json
.
Versions
Version | Date de sortie |
---|---|
v4.0.0 | 2016-10-21 |
v3.10.0 | 2016-06-17 |
v3.9.0 | 2016-05-06 |
v2.15.0 | 2016-03-11 |
v3.8.0 | 2016-02-26 |
v3.7.0 | 2016-01-29 |
v3.6.0 | 2016-01-21 |
v3.5.0 | 2015-11-20 |
v3.4.0 | 2015-11-06 |
v3.3.0 | 2015-08-14 |
v2.14.0 | 2015-08-14 |
v3.2.0 | 2015-07-25 |
v3.1.0 | 2015-07-03 |
v2.13.0 | 2015-07-03 |
v3.0.0 | 2015-06-26 |
v2.12.0 | 2015-06-19 |
v2.11.0 | 2015-05-22 |
v2.10.0 | 2015-05-08 |
v2.9.0 | 2015-04-24 |
v2.8.0 | 2015-04-10 |
v2.7.0 | 2015-02-27 |
v2.6.0 | 2015-02-13 |
v2.5.0 | 2015-01-30 |
v2.4.0 | 2015-01-23 |
v2.3.0 | 2015-01-16 |
v2.2.0 | 2015-01-09 |
v2.1.0 | 2014-09-26 |
v2.0.0 | 2014-09-13 |
v1.4.0 | 2014-02-13 |
Installation ou configuration
Installer
npm
est fourni avec Node.js , donc si vous installez Node.js, vous aurez automatiquement installé npm
. Vous pouvez choisir entre une version actuelle et une version LTS
les fenêtres
Pour Microsoft Windows, vous pouvez télécharger un programme d' installation MSI à l' adresse https://nodejs.org/en/download/ .
OS X
Pour Apple OS X, vous pouvez télécharger un programme d' installation PKG au même endroit https://nodejs.org/en/download/ .
Linux
Pour Linux, vous pouvez utiliser votre gestionnaire de paquets pour installer Node.js et npm.
Vous pouvez également compiler Node.js depuis le source et vous obtiendrez toujours npm
. Il y a aussi un script que vous pouvez exécuter pour installer npm
:
curl -L https://www.npmjs.com/install.sh | sh
Mettre à niveau npm vers la dernière version
La méthode recommandée pour mettre à jour votre installation npm
est de simplement installer npm
:
npm install -g npm@latest
Vous pouvez également mettre à niveau vers la version LTS actuelle plutôt que la version la plus récente:
npm install -g npm@lts
Vous pouvez également installer n'importe quelle version de Node (et npm) avec nvm
. Lorsque vous installez globalement avec npm
avec une installation nvm
, vous n'avez pas besoin d'utiliser sudo
(ou Exécuter en tant qu'administrateur sous Windows).
Installer des paquets
Notez que les packages peuvent être installésCette commande installe la version la plus récente des packages nommés:
à la fois localement ou globalement.
L'installation locale signifie que npm installe votre paquet dans le répertoire de travail en cours. Les modules de nœuds vont dans ./node_modules
, les exécutables vont dans ./node_modules/.bin/
. En général, vous souhaiterez installer des modules locaux pour une utilisation dans votre programme, en tant que dépendance, et ils fonctionneront uniquement là où ils sont installés.
npm install <package names>
Sténographie:
npm i <package names>
npm
peut interagir avec un fichier package.json
dans le répertoire en cours de diverses manières utiles, via les dependencies
objets et les devDependencies
stockées dans package.json
(installation de plusieurs modules):
La commande d' npm install
sans paramètres
npm install
installe tous les paquets nommés en tant que clés d'objet dans les objets dependencies
et devDependencies
de package.json
, en utilisant les restrictions de devDependencies
version sémantique indiquées par les valeurs d'objet.
Lors du développement de nouveaux logiciels:
Utilisez l'option -S
pour ajouter les <package names>
et les versions des modules npm que vous installez, qui doivent toujours être inclus avec votre module. Ajoute à la liste des dependencies
suivies dans le fichier package.json
, après l'installation.
npm i <package names> -S
Utilisez l'option -D
pour ajouter les <package names>
et les versions des modules npm que vous installez et que d'autres développeurs ont besoin pour développer ou tester votre module. Ajoute à la liste des devDependencies
suivis dans le fichier package.json
, après l'installation.
npm i <package names> -D
Où lodash
et mocha
sont des noms de paquets.
Installation de packages globaux
Installer un paquet global
Les paquets installés globalement suppriment les modules dans {prefix}/lib/node_modules
les fichiers exécutables dans {prefix}/bin
, où {prefix}
est généralement quelque chose comme /usr/local
. L'installation d'un module global signifie que ses fichiers binaires se retrouvent dans votre variable d'environnement PATH
. Habituellement, vous voudrez installer un module global s'il s'agit d'un outil de ligne de commande ou de quelque chose que vous souhaitez utiliser dans votre shell.
npm install --global package-name
Supprimer un package global
npm uninstall --global package-name
Note: l'argument --global
peut être simplifié à -g
. Ainsi, par exemple, la première commande pourrait être npm install -g package-name
, avec exactement le même résultat.
Remarque: dans les systèmes * nix, l'installation de packages globaux peut nécessiter des autorisations de superutilisateur. Ne pas le faire échouera avec: EACCES
. Dans ce cas, lancez:
sudo npm install --global package-name
Mise à jour des paquets
Dans chaque application, le cycle de vie survient un jour où ses composants doivent être mis à jour. Tout le monde connaît la peine de mettre à jour chaque dépendance individuellement. Eh bien, il vous suffit de lancer la commande:
npm update (-g)
Si le "-g" est là, alors npm mettra à jour les paquets globaux.
Utiliser npm pour gérer les dépendances
Vous souhaitez donc déployer votre application sur plusieurs sites? et votre projet a trop de dépendances pour les installer un par un? Npm a une solution, lancez simplement la commande suivante:
npm init
Dans le dossier racine du projet, suivez les instructions à l'écran (saisissez la valeur souhaitée puis appuyez sur Entrée), puis, si vous souhaitez enregistrer une dépendance, ajoutez:
--save
après ton
npm install
commandes par exemple:
npm install mypackagename --save
Et puis cette dépendance sera sauvegardée alors vous n'avez pas à déplacer le dossier "node_modules". Pour installer tous les problèmes de dépendance enregistrés:
npm install
et toutes les dépendances enregistrées seront installées.