Passer au contenu principal
Version : 8.x

pnpm add <pkg>

Installe un paquet ainsi que ses dépendances. Par défaut, les paquets sont installés comme dépendance de production (aka: "dependencies").

TL;DR

CommandMeaning
pnpm add saxSauvegarde en tant que dépendance de production (dependencies)
pnpm add -D saxSauvegarde en tant que dépendance de développement (devDependencies)
pnpm add -O saxSauvegarde en tant que dépendance optionnelle (optionalDependencies)
pnpm add -g saxInstalle un package globalement
pnpm add sax@nextInstalle la version next de sax
pnpm add sax@3.0.0Installe la version 3.0.0

Dépôts de paquets supportés

Installe depuis le dépôt NPM

Par défaut, la commande pnpm add package-name va installer la dernière version de package-name depuis le dépôt NPM.

Si elle est exécutée dans un espace de travail, la commande essaiera d'abord de vérifier si d'autres projets dans l'espace de travail utilisent le package spécifié. Si c'est le cas, la version déjà installée sera utilisée.

Vous pouvez également installer des paquets en spécifiant :

  • le tag : pnpm add express@nightly
  • la version : pnpm add express@1.0.0
  • un intervalle de versions : pnpm add express@2 react@">=0.1.0 <0.2.0"

Installer depuis un workspace

À noter que lorsqu'on travaille avec un workspace, et que l'on installe des dépendances, les paquets seront installés depuis les sources configurées. Et cela en fonction de si link-workspace-packages est configuré et des intervalles de version.

Installer à partir du système de fichiers local

Il existe deux façons d'installer à partir du système de fichiers local :

  1. à partir d'une archive (.tar, .tar.gzou .tgz)
  2. à partir d'un dossier

Exemples :

pnpm add ./package.tar.gz
pnpm add ./some-directory

Lorsque vous installez à partir d'un dossier, un lien symbolique sera créé dans le dossier node_modules du projet, donc cela revient à exécuter pnpm link.

Installer à partir d'une archive distante

L'argument doit être une URL correcte commençant par "http://" ou "https: //".

Exemple:

pnpm add https://github.com/indexzero/forever/tarball/v0.5.6

Installer à partir d'un dépôt Git

pnpm add <git remote url>

Installe le paquet depuis le dépôt Git en le clonant. Vous pouvez utiliser un protocole différent pour certains dépôts Git. Par exemple, pnpm add github:user/repo

Vous pouvez installer depuis Git à partir :

  • du dernier commit de master : pnpm add kevva/is-positive
  • d'un commit spécifié : pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678
  • d'une branche : pnpm add kevva/is-positive#master
  • d'une plage de versions : pnpm add kevva/is-positive#semver:^2.0.0

Options

--save-prod, -P

Installe les paquets spécifiés en tant que dépendance de production (dependencies).

--save-dev, -D

Installe les paquets spécifiés en tant que dépendance de développement (devDependencies).

--save-optional, -O

Installe les paquets spécifiés en tant que dépendance optionnelle (optionalDependencies).

--save-exact, -E

Les dépendances seront installées en utilisant la version exacte au lieu de la version venant de l'opérateur semver.

--save-peer

--save-peer ajoutera un ou plusieurs paquets en dépendances partagées (peerDependencies) et les installera en tant que dépendances de développement (devDependencies).

--ignore-workspace-root-check

On ne peut pas ajouter une dépendance à la racine du workspace à moins de rajouter le paramètre suivant : --ignore-workspace-root-check ou son raccourci -W.

Par exemple, pnpm add debug -W.

--global, -g

Installe un paquet de manière globale.

--workspace

Ajoute uniquement la nouvelle dépendance si elle se trouve dans le workspace.

--filter <selecteur_de_paquet>

En savoir plus sur le filtrage.