Файлы yarnrc (.yarnrc.yml)

Путь к папке, где хранятся загруженные пакеты в вашей системе. Они будут нормализованы, сжаты и сохранены в виде zip-архивов со стандартными именами. Кэш считается относительно безопасным для совместного использования несколькими проектами, даже если несколько экземпляров Yarn работают одновременно в разных проектах. Для установки глобальной папки кэша следует использовать enableGlobalCache вместо этого.

Путь к файлу, содержащему один или несколько сертификатов подписания Уполномоченного центра сертификации.

Базовые git-ссылки, по которым сравнивается текущий HEAD в плагине версии. Это переопределяет стандартное поведение сравнения со master, origin/master, upstream/master, main, origin/main и upstream/main. Поддерживает git-ветви, теги и коммиты.

Массив шаблонов glob. Файлы, соответствующие следующим шаблонам (относительно корня проекта), будут проигнорированы командой yarn version check.

Если throw (по умолчанию), Yarn выбросит исключение при yarn install, если обнаружит, что пакет не соответствует контрольной сумме, хранящейся в файле блокировки. Если update, контрольная сумма файла блокировки будет обновлена для соответствия новому значению. Если ignore, проверка контрольной суммы не будет выполняться.

Уровень сжатия, используемый для zip-архивов, где 0 — «без сжатия, быстрее», а 9 — «сильное сжатие, медленнее». По умолчанию используется «смешанный» вариант 9, где файлы могут храниться без сжатия, если встроенная функция libzip посчитает, что это приведёт к более разумному результату.

Путь к файлу ограничений.

Режим языка по умолчанию, который следует использовать, когда пакет не предоставляет информации.

Yarn — это модульный менеджер пакетов, который может разрешать пакеты из различных источников. Поэтому диапазоны semver и имена тегов работают не только с реестром npm — просто измените протокол по умолчанию на что-то другое, и ваши диапазоны semver будут извлекаться из выбранного вами источника.

Префикс по умолчанию для диапазонов зависимостей semantic version, который используется для новых зависимостей, устанавливаемых в манифест. Возможные значения — "^" (по умолчанию), "~" или "".

Папка, в которой хранятся файлы версиирования.

Если true (по умолчанию проверяет возможности терминала), Yarn отформатирует свой вывод с использованием цветов для различения важных частей сообщений.

Если true, Yarn проигнорирует настройки cacheFolder и сохранит файлы кэша в папке, общей для всех локальных проектов, использующих ту же конфигурацию.

Если true (по умолчанию проверяет возможности терминала), CLI разрешено использовать гиперссылки в выводе.

Если true, Yarn откажется от изменения кэша любым способом (добавления или удаления файлов) при выполнении yarn install.

Если true (по умолчанию в CI), Yarn откажется от изменения артефактов установки (кроме кэша) при выполнении команды install. Этот флаг достаточно навязчивый, обычно вы должны установить его только в CI, вручную передавая флаг --immutable команде yarn install.

Если true (по умолчанию в CI-средах), Yarn будет выводить вывод сборки непосредственно в терминал, а не буферизовать его в файле журнала.

Если true (по умолчанию), Yarn будет использовать глобальную папку как промежуточное звено между сетью и фактическим кэшем. Это значительно ускоряет установку для проектов, которые ещё не используют Zero-Installs.

Если false, Yarn никогда не будет самостоятельно обращаться к сети и вместо этого выбросит исключение, а не позволит этому произойти. Это очень полезная настройка для CI, которая обычно хочет убедиться, что она случайно не загружает зависимости из сети.

Если true (по умолчанию вне CI-среды), Yarn будет отображать индикаторы прогресса для длительных операций.

Если false, Yarn не будет выполнять скрипты postInstall при установке проекта. Обратите внимание, что теперь вы также можете отключать скрипты для отдельных пакетов благодаря dependenciesMeta.

Если false, ошибки сертификатов SSL будут игнорироваться

Если значение true (по умолчанию вне сред CI), Yarn будет периодически отправлять анонимные данные на наши серверы, отслеживая информацию об использовании, например, количество зависимостей в вашем проекте, сколько раз вы запускали установку и т. д. Подробную информацию об этом см. на странице Телеметрия.

Если значение false, Yarn не будет выводить время, затраченное на выполнение каждого подшага при выполнении различных команд. Это обычно необходимо для целей тестирования, когда вы хотите, чтобы каждое выполнение имело точно такой же вывод, как и предыдущие.

Если значение false, Yarn не будет связывать рабочие пространства только потому, что их версии соответствуют диапазону semver. Отключение этого параметра потребует, чтобы все обращения к рабочим пространствам осуществлялись через протокол workspace:. Это обычно требуется только в некоторых очень специфических случаях.

Путь, где хранятся все системные глобальные файлы (например, список всех пакетов, зарегистрированных через yarn link).

Определяет прокси-сервер, который необходимо использовать при выполнении HTTP-запроса. Обратите внимание, что Yarn в настоящее время поддерживает только HTTP-прокси (всё помощь приветствуется!).

Определяет прокси-сервер, который необходимо использовать при выполнении HTTPS-запроса. Обратите внимание, что Yarn в настоящее время поддерживает только HTTP-прокси (всё помощь приветствуется!).

Таймаут каждого http-запроса в миллисекундах

Количество попыток повторного выполнения http-запроса при ошибке

Если значение true, флаг --cwd будет проигнорирован.

Если значение true, локальный исполняемый файл будет проигнорирован при использовании глобального.

Массив шаблонов для файлов и каталогов, которые не должны изменяться при выполнении установок с флагом `--immutable`.

Область, используемая при создании пакетов с помощью команды init.

Дополнительные поля для установки при создании пакетов с помощью команды init.

Путь к файлу, где будет сохранено состояние установки.

Определяет переопределения уровней журналов для имён сообщений или текста сообщений. С помощью этого параметра можно скрывать определённые сообщения или придавать им большую важность.

Дополнительные настройки сети по имени хоста

В дополнение к глобальной конфигурации, реестры могут быть настроены для каждого scope (например, чтобы указать Yarn использовать ваш частный реестр при доступе к пакетам из данного scope). Поддерживаются следующие свойства:

Некоторые пакеты могли быть указаны некорректно в отношении их зависимостей — например, с отсутствием одной зависимости, что приводит к отказу Yarn в доступе. Поля packageExtensions предлагают способ расширить существующие определения пакетов дополнительной информацией. Если вы используете его, подумайте об отправке PR upstream и внесении своего расширения в базу данных plugin-compat. Примечание: это поле предназначено для добавления зависимостей; если вам нужно переписать существующие, лучше используйте поле resolutions.

Расположение, где Yarn будет читать и записывать файл .pnp.meta.json.

Если true, Yarn сгенерирует экспериментальный загрузчик ESM (.pnp.loader.mjs). Yarn пытается автоматически определить, требуется ли поддержка ESM.

Если true (по умолчанию), Yarn сгенерирует один файл .pnp.cjs, содержащий все необходимые данные для правильной работы вашего проекта. Если отключено, Yarn также сгенерирует файл .pnp.data.json, предназначенный для использования пакетом @yarnpkg/pnp.

Перечисление, значения которого (none, dependencies-only, all) определяют, в каком качестве хук PnP должен разрешать пакетам полагаться на встроенный механизм резервного копирования. В режиме dependencies-only (по умолчанию) ваши рабочие пространства не могут его использовать.

Массив шаблонов glob. Файлы, соответствующие следующим местоположениям (с точки зрения относительного пути по сравнению с сгенерированным файлом .pnp.cjs ), не будут охватываться PnP и будут использовать обычное разрешение Node. Обычно это необходимо только в том случае, если у вас есть подпроекты, которые еще не являются частью дерева вашего рабочего пространства.

Если strict (по умолчанию), Yarn не позволит модулям требовать пакеты, которые они явно не перечисляют в своих собственных зависимостях. Если loose, Yarn позволит доступ к пакетам, которые были бы подняты на верхний уровень в установках 1.x. Обратите внимание, что даже в свободном режиме такие вызовы небезопасны (правила подъема непредсказуемы) и следует избегать.

Заголовок, который будет добавлен в начало сгенерированного файла .pnp.cjs. Вам разрешено писать несколько строк, но это немного не приветствуется.

Путь, где отсоединенные пакеты будут храниться на диске.

Если true, Yarn будет печатать только отчет в одну строку о любых изменениях кэша.

Если true, Yarn будет использовать отложенную версионизацию (--deferred) по умолчанию при запуске семейства команд yarn version. Это может быть отменено на основе отдельной команды путем ручного задания флага --immediate.

Если true, Yarn будет запрашивать ваши указания, когда некоторые действия можно было бы улучшить, устранив неоднозначность. Включение этой настройки также открывает некоторые функции (например, команда yarn add будет предлагать повторное использование тех же зависимостей, что и другие рабочие пространства, если это уместно).

Если true, Yarn будет усекать строки, которые выходят за пределы размера терминала. Если индикаторы выполнения отключены, строки никогда не будут усекаться. Забываемые строки (например, журналы этапа извлечения) всегда усекаются.

Какой стиль индикатора выполнения следует использовать (только когда индикаторы выполнения включены). Допустимые значения можно найти здесь.

Эта настройка определяет имя файлов, которые Yarn ищет при разрешении файлов rc. По понятным причинам эту настройку нельзя задавать в файлах rc, и она должна быть определена в среде с помощью переменной YARN_RC_FILENAME.

Определяет системы, для которых Yarn должен устанавливать пакеты.