pnpm add <pkg>

Встановлює пакунок та будь-які пакунки, від яких він залежить. Стандартно будь-який новий пакунок встановлюється як залежність режиму production.

TL;DR

Команда	Значення
pnpm add sax	Зберегти до dependencies
pnpm add -D sax	Зберегти до devDependencies
pnpm add -O sax	Зберегти до optionalDependencies
pnpm add -g sax	Встановити пакунок глобально
pnpm add sax@next	Встановити з теґу next
pnpm add sax@3.0.0	Вказує версію 3.0.0`

Підтримувані розташування пакунків

Встановлення з npm registry

Стандартно pnpm add package-name встановить останню версію package-name з npm реєстру.

Якщо команда виконується в робочій області, команда спочатку спробує перевірити, чи інші проєкти у робочій області використовують вказаний пакунок. Якщо так, буде встановлено вже використаний діапазон версій.

Ви також можете встановити пакунки використовуючи:

• теґ: pnpm add express@nightly
• версію: pnpm add express@1.0.0
• діапазон версій: pnpm add express@2 react@">=0.1.0 <0.2.0"

Встановлення з робочої області

Зауважте, що під час додавання залежностей та роботи у [робочому просторі] пакунки буде встановлено з налаштованих джерел, залежно від того, чи встановлено параметр link-workspace-packages, та використання workspace: range protocol.

Встановлення з локальної файлової системи

Існує два способи встановлення з локальної файлової системи:

1. з файлу tar-архіву (.tar, .tar.gz, or .tgz)
2. з теки

Приклади:

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

Коли ви встановлюєте з теки, симлінк буде створено у node_modules поточного проєкту, тому це те саме, що й запуск pnpm link.

Встановлення з віддаленого tar архіву

Аргументом має бути URL-адреса, яка починається з "http://" або "https://".

Приклад:

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

Встановлення з репозиторію Git

pnpm add <git remote url>

Встановлює пакунок з хостингу Git-провайдера, клонуючи його за допомогою Git.

Ви можете встановити пакунок з Git використовуючи:

• Останній коміт зі стандартної гілки:

pnpm add kevva/is-positive

• Git хеш коміту:

pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678

• Гілку Git:

pnpm add kevva/is-positive#master

• Гілку Git відносно refs:

pnpm add zkochan/is-negative#heads/canary

• Теґ Git:

pnpm add zkochan/is-negative#2.0.1

• Теґ Git з V-префіксом:

pnpm add andreineculau/npm-publish-git#v0.0.7

Встановлення з репозиторію Git з використанням semver

Ви можете вказати версію (діапазон) для встановлення за допомогою параметра semver:. Наприклад:

• Конкретна версія:

pnpm add zkochan/is-negative#semver:1.0.0

• Конкретна версія з V-префіксом:

pnpm add andreineculau/npm-publish-git#semver:v0.0.7

• Діапазон версій:

pnpm add kevva/is-positive#semver:^2.0.0

• Діапазон версій з префіксом V:

pnpm add andreineculau/npm-publish-git#semver:<=v0.0.7

Встановлення з вкладених тек репозиторію Git

Ви також можете встановити лише вкладену теку з Git-хостингу монорепо за допомогою параметра path:. Наприклад:

pnpm add RexSkz/test-git-subdir-fetch#path:/packages/simple-react-app

Встановлення з репозиторію Git з використанням повного URL

Якщо ви хочете бути точнішими або використовуєте альтернативний хостинг Git, ви можете вказати повну URL-адресу Git:

# git+ssh
pnpm add git+ssh://git@github.com:zkochan/is-negative.git#2.0.1

# https
pnpm add https://github.com/zkochan/is-negative.git#2.0.1

Встановлення з Git-репозиторію з використанням короткого коду хостинг-провайдера

Ви можете використовувати скорочення протоколу [провайдер]: для певних провайдерів Git:

pnpm add github:zkochan/is-negative
pnpm add bitbucket:pnpmjs/git-resolver
pnpm add gitlab:pnpm/git-resolver

Якщо [провайдер]: не вказано, стандартним значенням буде github:.

Встановлення зі сховища Git, комбінуючи різні параметри

Можна обʼєднати кілька параметрів, розділивши їх символом &. Це може бути корисним для відгалужень монорепо:

pnpm add RexSkz/test-git-subdir-fetch.git#beta\&path:/packages/simple-react-app

Встановлюється з гілки beta і лише з вкладеної теки за адресою /packages/simple-react-app.

Параметри

--save-prod, -P

Встановлює вказані пакунки як звичайні dependencies.

--save-dev, -D

Встановлює вказані пакунки як devDependencies.

--save-optional, -O

Встановлює вказані пакунки як optionalDependencies.

--save-exact, -E

Збережені залежності (dependencies) буде сконфігуровано з точною версією, а не з використанням стандартного оператора діапазону semver.

--save-peer

Використання --save-peer додасть один або кілька пакунків до peerDependencies та встановить їх як залежності для розробки (dev dependencies).

--ignore-workspace-root-check

Додавання нової залежності до пакунка кореневого робочого простору завершиться невдачею, якщо не використовується прапорець --ignore-workspace-root-check або -w.

Наприклад, pnpm add debug -w.

--global, -g

Встановлює пакунок глобально.

--workspace

Додає нову залежність лише у випадку, якщо вона знаходиться в робочому просторі.

--allow-build

Added in: v10.4.0

Список назв пакунків, для яких дозволено запускати післяінсталяційні скрипти під час встановлення.

Приклад:

pnpm --allow-build=esbuild add my-bundler

This will run esbuild's postinstall script and also add it to the pnpm.onlyBuiltDependencies field of package.json. So, esbuild will always be allowed to run its scripts in the future.

--filter <package_selector>

Читайте більше про фільтрування.