Skip to main content
Version: 5.x

pnpm add <pkg>

Installe un paquet ainsi que ces 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 [email protected]Installe la version next de sax
pnpm add [email protected]Installe 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. Pour installer un paquet à partir d' autre registre, vous pouvez utiliser le lien tarball (voir le guide correspondant).

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

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

Examples:

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: //".

Example:

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. For example, 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

Added in: v3.2.0

--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, -W

Ajouté dans la version v3.6.0

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

Par exemple, pnpm add debug -W.

--global

Installe un paquet de manière globale.

--workspace

Added in: v4.4.0

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

--filter <package_selector>

Read more about filtering.