yarn add

Syntaxe

Paramètres

Description

Cette commande permet d'ajouter des dépendances au projet.

Remarques

• Cette commande ajoute un paquet au package.json pour l'espace de travail le plus proche.
• S'il n'existait pas auparavant, le paquet sera par défaut ajouté au champ des dépendances régulières, mais ce comportement peut être remplacé grâce à le paramètre -D, -dev (ce qui entraînera l'ajout de la dépendance au champ devDependencies à la place) et le paramètre -P, -peer (qui fera la même chose mais pour peerDependencies).
• Si le paquet était déjà répertorié dans vos dépendances, il sera mis à niveau par défaut, qu'il fasse partie de vos dépendances ou de devDependencies (il ne mettra jamais à jour peerDependencies, cependant).
• S'il est défini, le paramètre --prefer-dev fonctionnera comme un -D, -dev plus flexible en ce sens qu'il ajoutera le paquet à vos devDependencies s'il n'est pas déjà répertorié dans les dépendances ou devDependencies, mais il sera également heureux mettez à niveau vos dépendances si c'est ce que vous utilisez déjà (alors que -D, -dev lèverait une exception).
• S'il est défini, le paramètre -O, --optional ajoutera le paquet au champ optionalDependencies et, en combinaison avec le paramètre -P, -peer, il ajoutera le paquet en tant que dépendance d'homologue facultative. Si le paquet était déjà répertorié dans vos dépendances, il sera mis à niveau vers optionalDependencies. Si le paquet était déjà répertorié dans vos peerDependencies, en combinaison avec le paramètre -P, -peer, il sera mis à niveau vers une dépendance d'homologue facultative : «"peerDependenciesMeta": {"package": {"optional": true} }».
• Si le paquet ajouté ne spécifie pas du tout l'intervalle, sa dernière balise sera résolue et la version retournée sera utilisée pour générer une nouvelle intervalle de semver (en utilisant le modificateur ^ par défaut, sauf configuration contraire via la configuration defaultSemverRangePrefix, ou le modificateur ~ si -T, -tilde est spécifié, ou pas de modificateur du tout si -E, -exact est spécifié). Deux exceptions à cette règle : la première est que si le paquet est un espace de travail, sa version locale sera utilisée, et la seconde est que si vous utilisez -P, -pair l'intevalle par défaut sera * et ne sera pas être résolu du tout.
• Si le paquet ajouté spécifie un intervalle (telle que ^ 1.0.0, latest ou rc), le Yarn ajoutera cette intervalle telle quelle dans l'entrée package.json résultante (en particulier, les balises telles que rc seront codées telles quelles plutôt que d'être converti en une intervalle semver).
• Si l'option --cached est utilisée, Yarn réutilisera de préférence la version la plus élevée déjà utilisée quelque part dans le projet, même si via une dépendance transitive.
• Si l'option -i, --interactive est utilisée (ou si les paramètres preferInteractive sont activés), la commande essaiera d'abord de vérifier si d'autres espaces de travail du projet utilisent le paquet spécifié et, si c'est le cas, proposera de les réutiliser.

Exemples

Cette exemple permet d'ajouter un paquet standard à l'espace de travail actuel :

Cette exemple permet d'ajouter une version spécifique d'un paquet à l'espace de travail actuel :

Cette exemple permet d'ajouter un paquet d'un dépôt GitHub (la branche master) à l'espace de travail actuel à l'aide d'une URL :

Cette exemple permet d'ajouter un paquet d'un dépôt GitHub (la branche master) à l'espace de travail actuel à l'aide du protocole GitHub :

Cette exemple permet d'ajouter un paquet d'un dépôt GitHub (la branche principale) à l'espace de travail actuel à l'aide du protocole GitHub (raccourci) :

Cette exemple permet d'ajouter un paquet d'une dépôt spécifique d'un dépôt GitHub à l'espace de travail actuel à l'aide du protocole GitHub (raccourci) :