2. yarn add

Устанавливает пакет и все пакеты, от которых он зависит.

Добавление зависимостей

В общем случае, пакет — это просто папка с кодом и файлом package.json , который описывает содержимое. Когда вы хотите использовать другой пакет, сначала нужно добавить его в свои зависимости. Это означает запуск yarn add [package-name] для его установки в свой проект.

Это также обновит ваш package.json и ваш yarn.lock, чтобы другие разработчики, работающие над проектом, получали те же зависимости, что и вы, при выполнении yarn или yarn install.

Большинство пакетов будут установлены с реестра npm и обозначаться просто по имени пакета. Например, yarn add react установит пакет react из реестра npm.

Вы можете указать версии, используя один из этих методов:

1. yarn add package-name устанавливает «самую последнюю» версию пакета.
2. yarn add package-name@1.2.3 устанавливает конкретную версию пакета из реестра.
3. yarn add package-name@tag устанавливает конкретную “метку” (например, beta, next, или latest).

Вы также можете указать пакеты из разных мест:

1. yarn add package-name устанавливает пакет из реестра npm, если вы не указали другой в вашем package.json.
2. yarn add file:/path/to/local/folder устанавливает пакет из вашей локальной файловой системы. Это полезно для тестирования ваших собственных пакетов, которые еще не опубликованы в реестре.
3. yarn add file:/path/to/local/tarball.tgz устанавливает пакет из сжатого в gzip tar-архива, что может использоваться для совместного использования пакета до его публикации.
4. yarn add link:/path/to/local/folder устанавливает символическую ссылку на пакет из вашей локальной файловой системы. Это полезно для разработки связанных пакетов в средах monorepo.
5. yarn add <git remote url> устанавливает пакет из удаленного репозитория git.
6. yarn add <git remote url>#<branch/commit/tag> устанавливает пакет из удаленного репозитория git по конкретной ветке git, коммиту git или метке git.
7. yarn add https://my-project.org/package.tgz устанавливает пакет из удаленного сжатого в gzip tar-архива.

Ограничения

Если вы ранее использовали менеджер пакетов, например npm, вы можете искать способ добавления глобальных зависимостей.

Для подавляющего большинства пакетов наличие глобальных зависимостей считается плохой практикой, так как они неявны. Гораздо лучше добавлять все зависимости локально, чтобы они были явными, и любой другой пользователь вашего проекта получал тот же набор зависимостей.

Если вы пытаетесь использовать утилиту командной строки (CLI), которая имеет bin, вы можете получить доступ к ним в вашем каталоге ./node_modules/.bin. Вы также можете использовать команду global:

yarn global add <package...>

Команды

yarn add <package...>

Это установит один или несколько пакетов в ваши dependencies.

yarn add <package...> [--dev/-D]

Использование --dev или -D установит один или несколько пакетов в ваши devDependencies.

yarn add <package...> [--peer/-P]

Использование --peer или -P установит один или несколько пакетов в ваши peerDependencies.

yarn add <package...> [--optional/-O]

Использование --optional или -O установит один или несколько пакетов в ваши optionalDependencies.

yarn add <package...> [--exact/-E]

Использование --exact или -E устанавливает пакеты как точные версии. По умолчанию используется самая последняя версия с той же основной версией. Например, yarn add foo@1.2.3 будет принимать версию 1.9.1, но yarn add foo@1.2.3 --exact будет принимать только версию 1.2.3.

yarn add <package...> [--tilde/-T]

Использование --tilde или -T устанавливает самые последние версии пакетов с той же дополнительной версией. По умолчанию используется самая последняя версия с той же основной версией. Например, yarn add foo@1.2.3 --tilde будет принимать 1.2.9, но не 1.3.0.

yarn add <package...> [--ignore-workspace-root-check/-W]

Использование --ignore-workspace-root-check или -W позволяет установить пакет в корне рабочей области. Как правило, этого не желательно делать, так как зависимости обычно должны быть частью рабочей области. Например, yarn add lerna --ignore-workspace-root-check --dev в корне рабочей области позволит использовать lerna в скриптах корневого package.json.

yarn add <alias-package>@npm:<package>

Это установит пакет под пользовательским псевдонимом. Использование псевдонимов позволяет устанавливать несколько версий одной и той же зависимости, каждая из которых ссылается на имя alias-package. Например, yarn add my-foo@npm:foo установит пакет foo (самую последнюю версию) в ваши dependencies под заданным псевдонимом my-foo. Также, yarn add my-foo@npm:foo@1.0.1 позволяет установить конкретную версию foo.

yarn add <package...> --audit

Проверяет наличие известных проблем безопасности в установленных пакетах. Количество найденных проблем будет добавлено в вывод. Используйте команду yarn audit для получения дополнительных деталей.