Konečný průvodce konfigurací NPM

Úvod

Správce balíčků Node neboli npm je podle mého názoru jednou z nejlepších částí o Node. Správa balíčků dokáže jazyk skutečně vytvořit nebo rozbít, takže je nesmírně důležité zajistit, aby byl snadno použitelný a flexibilní.

Po celou dobu používání Node jsem znal pouze základní příkazy npm jako save , install a publish , a ani tehdy jsem pořádně neznal volitelné parametry, které k nim patřily. Po nedávném přečtení některé dokumentace nápovědy jsem si myslel, že by bylo užitečné napsat podrobnosti o co největším počtu konfigurací npm. Nejen, že si myslím, že by to mohlo být užitečné pro čtenáře, ale pro mě bylo nesmírně užitečné podívat se na všechny různé příznaky/parametry a skutečně je otestovat. Nakonec jsem se naučil hodně o npm, což mi v budoucnu hodně pomůže.

Z větší části jsem se snažil napsat jedinečný popis každého parametru (odlišný od nápovědy). Doufejme, že pokud vás dokumenty nápovědy zmást (nebo nebudou mít dostatek informací), můj popis vám poskytne více informací o tom, co hledáte. Přidám také příklady některých více matoucích parametrů, takže pokud víte, jak používat některé z více nezdokumentovaných možností, například searchopts , rád bych viděl příklad!

Nastavení parametrů

Pokud není uvedeno jinak, všechny níže uvedené parametry lze nastavit pomocí několika různých metod, z nichž každou zde stručně popíšu. V závislosti na vašem případu použití použijte různé účely pro věci, jako je testování, konfigurace specifická pro projekt, globální konfigurace atd.

soubory npmrc

npm vám umožňuje používat několik různých rc souborů, podobně jako ~/.bashrc , pro nastavení vašich konfigurací. Čtyři umístění, kde mohou soubory být, jsou:

  • Konfigurační soubor pro jednotlivé projekty:/path/to/my/project/.npmrc
  • Konfigurační soubor pro uživatele:~/.npmrc
  • Globální konfigurační soubor:$PREFIX/npmrc
  • Vestavěný konfigurační soubor npm:/path/to/npm/npmrc
https-proxy=proxy.example.com
init-license=MIT
init-author-url=http://stackabuse.com
color=true

Soubor, který byste měli použít, závisí na parametru a rozsahu, který chcete nastavit. Takže například budete pravděpodobně chtít nastavit https-proxy v globálním souboru npmrc na rozdíl od souboru npmrc na úrovni projektu, protože všechny projekty v systému budou potřebovat nastavení proxy.

Proměnná prostředí

Existuje několik proměnných prostředí, které npm použije nad parametry nastavenými lokálně (nebo v souboru npmrc). Některé příklady jsou NODE_ENV a HTTPS_PROXY . Můžete také nastavit libovolné npm přidáním předpony proměnné prostředí npm_config_ . Tímto způsobem můžete dělat věci jako export npm_config_registry=localhost:1234 .

Mnoho lidí je zvyklých používat pro konfiguraci proměnné prostředí, takže by jim to mělo být známé. Například skvělý způsob, jak nakonfigurovat instanci Dockeru, je nastavit proměnné prostředí z dockerfile.

Příznaky na příkazovém řádku

Ne všechny parametry musí být trvale nastaveny v souboru nebo proměnné prostředí. Mnohé z nich lze použít v rámci příkazu npm jako příznak s předponou -- .

Pokud například instalujete nový balíček z registru a chcete jej uložit do package.json soubor, budete chtít použít --save vlajky, ale nemusí to tak být vždy. V některých případech můžete chtít použít --save-dev nebo dokonce --save-optional , takže by nemělo smysl používat npmrc.

soubor package.json

V rámci vašeho package.json projekt, můžete také nastavit parametry. V tomto případě config mapa by měla být použita takto:

{
  "name": "module-name",
  "version": "10.3.1",
  "config": {
    "foo": "bar",
    "test-param": 12
  },
  "dependencies": {
    "express": "4.2.x",
  }
}

Potom z vašeho kódu můžete přistupovat k těmto parametrům pomocí process globální proměnná, jako je tato:process.env.npm_package_config_foo . Všimněte si předpony npm_package_config_ , který říká Node, odkud má proměnnou získat.

Poznámka :Toto bude fungovat pouze tehdy, když svůj projekt spustíte prostřednictvím skriptu npm (tj. ne stačí použít node index.js ).

sada konfigurace npm

A konečně je tu vždy možnost nastavit parametry pomocí npm config set . Toto bude mít přednost před package.json konfigurace. Pokud jste tedy například spustili npm config set module-name:foo baz z příkazového řádku (a měl package.json soubor shora), pak vaše foo parametr by byl baz místo bar . module-name scoping zajistí, že tato proměnná nebude nastavena pro žádné jiné projekty.

Stejně jako výše uvedená metoda, aby to fungovalo, musíte spusťte program pomocí skriptu npm, například npm run .

Seznam možných parametrů

Snažil jsem se kategorizovat každý parametr co nejlépe, ale mnoho z nich by fungovalo dobře i v jiných kategoriích. Takže po chvíli přemýšlení jsem prostě zařadil každý parametr do kategorie, která dávala z kontextu největší smysl.

Doufám, že jsem to udělal dostatečně dobře, že jsem to zorganizoval, takže to můžete použít jako odkaz. Neváhejte a dejte mi vědět, pokud tam jsou nějaké chyby nebo opomenutí!

Řízení přístupu/autorizace

přístup

Tím se nastaví úroveň přístupu k rozsahu balíčku, která je výchozí restricted . Nastavení tohoto parametru na public umožňuje jej veřejně zobrazit a nainstalovat. Pokud váš projekt nemá rozsah, pak je veřejný.

  • Výchozí:omezeno
  • Typ:Přístup (řetězec)
vždy-auth

Nastavte na hodnotu true, pokud chcete vyžadovat ověření pro každý čas, kdy přistupujete k registru, a to i pro požadavky GET.

  • Výchozí:false
  • Typ:Boolean
ca

Toto je podpisový certifikát certifikační autority, který se používá pro důvěryhodnost připojení SSL k registru balíčků. Chcete-li zadat certifikát, použijte formát PEM a nahraďte všechny nové řádky kódem \n charakter. Nastavení CA tedy může vypadat například takto:

ca="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----"

Můžete také důvěřovat více CA zadáním pole certifikátů, jednoho pro každý řádek:

ca[]="..."
ca[]="..."

Nebo nastavením ca na null určí výchozí známé registrátory.

  • Výchozí:Certifikát CA npm
  • Typ:Řetězec, Pole nebo null
cafile

Podobné jako ca parametr, cafile umožňuje nastavit důvěryhodný certifikát pro připojení k registru. Rozdíl je v tom, že můžete zadat cestu k souboru k certifikátu, který může obsahovat jeden nebo více certifikátů.

  • Výchozí:null
  • Typ:cesta
certifikát

cert parametr určuje klientský certifikát pro ověřování pomocí registru. Toto je protiklad k předchozímu ca a cafile certifikáty v tom, že slouží k ověřování klienta namísto ověřování registru. Pokud hostujete svůj vlastní registr, může to být dobrý způsob, jak jej učinit soukromým, aniž byste se museli ověřovat uživatelským jménem a heslem.

  • Výchozí:null
  • Typ:Řetězec

Ukládání do mezipaměti

mezipaměť

Toto je umístění adresáře mezipaměti npm.

  • Výchozí:Windows:%AppData%\npm-cache , Posix:~/.npm
  • Typ:cesta
zablokování mezipaměti

Počet milisekund před tím, než jsou soubory uzamčení složky mezipaměti považovány za zastaralé.

  • Výchozí:60 000 (1 minuta)
  • Typ:Číslo
cache-lock-retries

Počet opakování pokusu o získání zámku na lockfiles složky mezipaměti.

  • Výchozí:10
  • Typ:Číslo
cache-lock-wait

Počet milisekund čekání na vypršení platnosti souborů zámku mezipaměti.

  • Výchozí:10 000 (10 sekund)
  • Typ:Číslo
cache-max

Toto je maximální doba (v sekundách), po kterou je položka uložena do mezipaměti před aktualizací pomocí registru. Pokud tedy očekáváte, že se balíček bude měnit poměrně často, budete chtít toto číslo nastavit na nižší číslo.

Balíčky uložené v mezipaměti jsou vyčištěny pouze tehdy, když je npm cache clean Používá se příkaz (nebo můžete balíčky ručně vyčistit a vybrat, které mají být vyčištěny).

  • Výchozí:Nekonečno
  • Typ:Číslo
min mezipaměti

Opak cache-max parametr, cache-min parametr nastavuje minimální dobu (v sekundách), po kterou se položky ponechají v mezipaměti před opětovnou kontrolou v registru.

  • Výchozí:10
  • Typ:Číslo

Obecné

barva

color param určuje, zda je ve výstupu npm použito zbarvení. Pokud je nastaveno na hodnotu true, pak npm tiskne pouze barvy pro deskriptory souborů tty. Nebo jej můžete nastavit na always vždy používat barvy.

  • Výchozí:true na Posix, false na Windows
  • Typ:Boolean nebo „vždy“
popis

Určuje, zda se při použití npm search zobrazí popis balíčku .

  • Výchozí:true
  • Typ:Boolean
vynutit

Pomocí force budou různé příkazy silnější. Můžete si to skoro představit jako použití sudo , kde budete moci obejít určitá omezení. Abychom uvedli několik příkladů, použití tohoto by znamenalo, že selhání skriptu životního cyklu neblokuje pokrok, publikování přepíše dříve publikované verze, npm přeskočí mezipaměť při požadavku z registru nebo zabrání kontrolám proti přepsání souborů jiných než npm.

  • Výchozí:false
  • Typ:Boolean
globální

global způsobí, že daný příkaz bude fungovat v „globálním“ režimu. K balíčkům nainstalovaným v této složce mají přístup všichni uživatelé a projekty v systému. To znamená, že balíčky se instalují do složky 'prefix', což je obvykle místo, kde je nainstalován uzel. Konkrétně budou globální balíčky umístěny na {prefix}/lib/node_modules , soubory bin budou propojeny s {prefix}/bin a manuálové stránky by byly propojeny s {prefix}/share/man .

  • Výchozí:false
  • Typ:Boolean
globalconfig

Umístění konfiguračního souboru, který se má číst pro globální možnosti konfigurace.

  • Výchozí:{prefix}/etc/npmrc
  • Typ:cesta
skupina

Tento parametr říká npm, kterou skupinu systémů má použít při spouštění skriptů balíčků v globálním režimu jako uživatel root.

  • Výchozí:ID skupiny aktuálního procesu
  • Typ:Řetězec nebo Číslo
dlouhé

Zda zobrazit podrobné informace při spuštění npm ls a npm search .

  • Výchozí:false
  • Typ:Boolean
předpona

Toto je umístění, kde jsou nainstalovány globální položky, což je ve výchozím nastavení umístění instalace samotného npm. Pokud prefix je nastaven na příkazovém řádku, pak jsou neglobální příkazy nuceny spouštět v dané složce.

  • Výchozí:viz npm help 5 folders
  • Typ:cesta
točení

spin Parametr určuje, zda se zobrazí ASCII spinner, když npm čeká nebo něco zpracovává (za předpokladu, že process.stderr je TTY). Toto lze nastavit na false pro úplné potlačení spinneru, nebo nastavit na „vždy“ pro výstup spinneru i pro non-TTY výstupy.

  • Výchozí:true
  • Typ:Boolean nebo „vždy“
tmp

Adresář, kde jsou uloženy dočasné soubory a adresáře. Po úspěšném dokončení procesu npm budou všechny soubory a adresáře odstraněny. Pokud však proces selže, soubory a adresáře nejsou odstraněny, abyste je mohli zkontrolovat a odladit problém.

  • Výchozí:proměnná prostředí TMPDIR neboli "/tmp"
  • Typ:cesta
unicode

unicode Parametr říká npm, zda má ve výstupu stromu použít znaky unicdoe. Pokud false , ke kreslení stromů se používají pouze znaky ASCII.

  • Výchozí:true
  • Typ:Boolean
unsafe-perm

Když unsafe-perm je nastaven na true , přepínání ID uživatele/skupiny je při spuštění skriptu balíčku potlačeno. Pokud false , uživatelé bez oprávnění root nebudou moci instalovat balíčky.

  • Výchozí:false, pokud je spuštěn jako root, v opačném případě true
  • Typ:Boolean
použití

Pomocí usage příznak snižuje množství výstupu při získávání nápovědy pro příkaz. Místo toho, abychom vám ukazovali všechny možné příznaky/vstupy do příkazu, jako je -H flag by, jen vám poskytne podstatu dokumentace nápovědy. Takže například spuštění npm --usage search vypíše npm search [some search terms ...] .

  • Výchozí:false
  • Typ:Boolean
uživatel

Toto je UID, které se má použít, když je skript balíčku spuštěn jako uživatel root. Pokud tedy nechcete, aby měl skript oprávnění root, nastavte toto na UID uživatele, který má správnou úroveň oprávnění a přístup pro aplikaci. Spuštění skriptu balíčku jako root může být nebezpečné!

  • Výchozí:"nobody"
  • Typ:Řetězec nebo Číslo
userconfig

Toto je umístění konfiguračního souboru na úrovni uživatele. Každý uživatel v systému může mít různá nastavení pro instalaci npm a soubor by měl být umístěn v cestě uvedené v userconfig .

  • Výchozí:~/.npmrc
  • Typ:cesta
umask

Toto je hodnota masky, která se použije při nastavování režimu vytváření souborů pro soubory i adresáře. Typ vytvářeného souboru/adresáře závisí na použité hodnotě masky. Pokud se jedná o adresář nebo spustitelný soubor, pak umask hodnota je maskována proti 0777 . U všech ostatních souborů umask hodnota je maskována proti 0666 . Výchozí nastavení je 0755 a 0644 respektive, což je poměrně konzervativní maska ​​pro každý typ souboru.

  • Výchozí:022
  • Typ:osmičkový číselný řetězec v rozsahu 0000..0777 (0..511)
verze

Pomocí tohoto příznaku se zobrazí nainstalovaná verze npm. Toto funguje pouze při použití na příkazovém řádku jako příznak jako npm --version .

  • Výchozí:false
  • Typ:boolean
verze

Použití tohoto příznaku je podobné jako version , ale vydává podrobnosti o verzi (jako JSON) na několika různých balíčcích, včetně projektu v aktuálním adresáři (pokud existuje), V8, npm a podrobností z process.versions . Toto funguje pouze při použití na příkazovém řádku jako příznak jako npm --versions .

Příklad výstupu může vypadat takto:

{ 'my-project': '0.0.1',
  npm: '2.14.2',
  http_parser: '2.3',
  modules: '14',
  node: '0.12.2',
  openssl: '1.0.1m',
  uv: '1.4.2-node1',
  v8: '3.28.73',
  zlib: '1.2.8' }
  • Výchozí:false
  • Typ:boolean
prohlížeč

Toto je program, který se používá při prohlížení obsahu nápovědy. Pokud je nastaveno na „prohlížeč“, otevře se výchozí webový prohlížeč a zobrazí obsah nápovědy v HTML.

  • Výchozí:"man" na Posix, "prohlížeč" na Windows
  • Typ:cesta, 'muž' nebo 'prohlížeč'

Vývoj

dev

Použití tohoto příznaku při instalaci balíčků nainstaluje také balíčky dev-dependencies. Toto by se mělo používat téměř vždy, když zrovna neběží projekt v produkci.

Je to podobné jako npat vlajka.

  • Výchozí:false
  • Typ:Boolean
editor

Toto je příkaz (nebo cesta ke spustitelnému souboru), který se má spustit při otevření editoru.

  • Výchozí:proměnná prostředí EDITOR, pokud je nastavena, nebo "vi" na Posix nebo "notepad" na Windows.
  • Typ:cesta
přísné pro motor

Tento parametr říká npm, zda se má řídit specifikací motoru v package.json soubor přísně. Pokud je nastaveno na true , pak se instalace balíčku nezdaří, pokud aktuální verze Node.js neodpovídá zadané verzi.

To je užitečné, když balíček vyžaduje určitou verzi Node.js nebo dokonce io.js (pravděpodobně proto, že balíček používá funkce ES6).

  • Výchozí:false
  • Typ:Boolean
git

Toto by měl být příkaz, který se má použít pro spouštění příkazů git. To by mohlo být užitečné, když je nainstalován git, ale není na PATH, v takovém případě byste měli zadat cestu k instalaci git.

  • Výchozí:"git"
  • Typ:Řetězec
verze git-tag

To říká npm, zda má označit odevzdání při spuštění npm version příkaz (který změní verzi balíčku a uloží ji do package.json ). To může pomoci omezit chyby (zapomenutí označit git commit, označit jej jako špatnou verzi atd.), ale také vám to poskytne méně kontroly, takže budete muset zvážit kompromisy.

  • Výchozí:true
  • Typ:Boolean
nadpis

Řetězec, který se má vytisknout při výstupu informací o ladění.

  • Výchozí:"npm"
  • Typ:Řetězec
pokud existuje

Při použití npm run-script příkaz, pokud skript není definován v package.json soubor, pak npm skončí s chybovým kódem. Pokud if-present je nastaven na true , pak se chybový kód nevrací. To je užitečné, když chcete volitelně spustit skript, ale je vám jedno, jestli není přítomen. Takže například možná máte skript (script A ), který je přítomen v některých vašich projektech, ale ne ve všech, a používáte jiný obecný skript (script B ) spustit. Tímto způsobem, pokud skript A není přítomen, pak skript B nezobrazí chybu a může bezpečně pokračovat ve spuštění.

  • Výchozí:false
  • Typ:Boolean
ignore-scripts

Zdarma e-kniha:Git Essentials

Prohlédněte si našeho praktického průvodce učením Git s osvědčenými postupy, průmyslově uznávanými standardy a přiloženým cheat sheetem. Přestaňte používat příkazy Google Git a skutečně se naučte to!

Nastavte tento příznak, aby se nespouštěly žádné skripty definované v package.json soubor projektu.

  • Výchozí:false
  • Typ:Boolean
init-module

Toto je cesta k souboru JavaScript, který pomáhá s inicializací projektu. Pokud tedy máte vlastní konfiguraci, kterou chcete, aby všechny vaše nové projekty měly (například závislost na Bluebirdu nebo výchozím enginu), můžete v určeném umístění vytvořit soubor, který inicializaci zvládne za vás.

  • Výchozí:~/.npm-init.js
  • Typ:cesta
init-author-name

Výchozí název používaný npm init při vytváření nového projektu.

  • Výchozí:""
  • Typ:Řetězec
e-mail init-autora

Výchozí e-mail autora používaný npm init při vytváření nového projektu.

  • Výchozí:""
  • Typ:Řetězec
init-author-url

Výchozí adresa URL autora používaná npm init při vytváření nového projektu.

  • Výchozí:""
  • Typ:Řetězec
init-licence

Výchozí licence používaná npm init při vytváření nového projektu.

  • Výchozí:"ISC"
  • Typ:Řetězec
verze init

Výchozí verze používaná npm init při vytváření nového projektu.

  • Výchozí:"1.0.0"
  • Typ:Řetězec
json

Tento parametr určuje, zda npm zapíše svůj výstup jako json nebo běžný text.

POZNÁMKA :npm tvrdí, že tato funkce je experimentální a struktura objektů hte JSON se může změnit.

  • Výchozí:false
  • Typ:Boolean

Pokud link je nastavena na hodnotu true, pak budou místní instalace spojeny s instalacemi globálního balíčku (pokud je přítomen odpovídající balíček). Jedním z důležitých vedlejších produktů těchto funkcí je, že propojením s globálními balíčky mohou místní instalace způsobit instalaci dalších věcí v globálním prostoru.

Odkazy se vytvoří, pokud je splněna alespoň jedna ze dvou podmínek:

  • Balíček ještě není nainstalován globálně

  • globálně nainstalovaná verze je totožná s verzí, která se instaluje lokálně

  • Výchozí:false

  • Typ:Boolean

místní-adresa

Toto je IP adresa místního síťového rozhraní systému, která se použije při připojení k registru npm.

POZNÁMKA :Musí to být adresa IPv4 v Node v0.12 a dřívějších.

  • Výchozí:nedefinováno
  • Typ:IP adresa
úroveň protokolu

Toto je výchozí úroveň protokolu pro spuštění vaší aplikace. Pokud je zaznamenána událost vyšší (nebo rovna) než je zde uvedená, je odeslána uživateli. Když/pokud aplikace selže, vše protokoly se zapisují do npm-debug.log v aktuálním pracovním adresáři.

  • Výchozí:"warn"
  • Typ:Řetězec
logstream

Stream používaný npmlog balíček za běhu.

POZNÁMKA :Toto nelze nastavit na příkazovém řádku. K jeho konfiguraci musíte použít jinou metodu, například soubor nebo proměnnou prostředí.

  • Výchozí:process.stderr
  • Typ:Stream
zpráva

Toto je zpráva odevzdání, kterou má použít npm version příkaz. Formátovací znak '%s' bude nahrazen číslem verze.

  • Výchozí:"%s"
  • Typ:Řetězec
verze uzlu

Verze uzlu použitá při kontrole engines balíčku deklarace v package.json soubor.

  • Výchozí:process.version
  • Typ:semver nebo false
npat

Zda se mají při instalaci spustit testy balíčku.

  • Výchozí:false
  • Typ:Boolean
onload-script

Toto je umístění balíčku requre() jednou načte npm. Toto se doporučuje pro programové použití npm.

  • Výchozí:false
  • Zadejte:cesta nebo 'false'
volitelné

To řekne npm, aby nainstaloval balíčky z optionalDependencies mapa v package.json soubor. Protože jsou volitelné závislosti, pokud se instalace nepodaří, npm nebude přerušit proces.

  • Výchozí:true
  • Typ:Boolean
parsovatelné

parseable parametr říká npm, aby při zápisu na standardní výstup zformátoval svůj výstup do analyzovatelného formátu.

  • Výchozí:false
  • Typ:Boolean
produkce

Při nastavení na true , npm běží v produkčním režimu, což většinou znamená pouze devDependencies nejsou nainstalovány. Všimněte si, že byste měli použít NODE_ENV="production" při použití skriptů životního cyklu.

  • Výchozí:false
  • Typ:Boolean
vrácení zpět

Použití tohoto příznaku s npm odstraní všechny balíčky, které se nepodařilo nainstalovat (například kvůli chybě kompilace/závislosti).

  • Výchozí:true
  • Typ:Boolean
uložit

Použití tohoto příznaku s npm uloží daný balíček do lokálního package.json soubor pod dependencies . Případně použijte tento příznak s npm rm příkaz odstraní závislost z dependencies části package.json soubor.

Všimněte si, že to funguje pouze při package.json soubor se nachází v aktuálním adresáři.

  • Výchozí:false
  • Typ:Boolean
save-bundle

Pokud je balíček uložen v době instalace pomocí --save , --save-dev nebo --save-optional flags, pak jej také vložte do bundleDependencies seznam. Při použití s ​​npm rm odebere jej z bundledDependencies seznam.

  • Výchozí:false
  • Typ:Boolean
save-dev

Použití tohoto příznaku uloží balíčky do devDependencies seznam v package.json soubor. Opak je pravdou při použití s ​​npm rm , což znamená, že balíček bude odstraněn z devDependencies . Stejně jako save příznak, funguje to pouze v případě, že existuje package.json soubor je přítomen.

  • Výchozí:false
  • Typ:Boolean
uložit-přesně

Když je závislost uložena do package.json pomocí jednoho z --save , --save-dev nebo --save-optional flags, pak bude nakonfigurován pomocí přesného čísla verze namísto výchozího operátoru rozsahu semver npm.

  • Výchozí:false
  • Typ:Boolean
volitelné uložení

Použití tohoto příznaku uloží balíčky do optionalDependencies seznam v package.json soubor. Opak je pravdou při použití s ​​npm rm , což znamená, že balíček bude odstraněn z optionalDependencies . Stejně jako save příznak, toto funguje pouze v případě, že existuje package.json soubor je přítomen.

  • Výchozí:false
  • Typ:Boolean
save-prefix

Tento parametr určuje, jak se balíčky ukládají do package.json při použití s ​​--save nebo --save-dev vlajky. Jako příklad použijeme výchozí hodnotu, pokud uložíme balíček s verzí 1.2.3 , pak bude skutečně uložen v package.json jako ^1.2.3 .

  • Výchozí:'^'
  • Typ:Řetězec
rozsah

Pomocí scope sděluje npm, jaký rozsah použít pro omezený registr. To může být užitečné při prvním použití soukromého registru. Příklad:

npm login [email protected] --registry=registry.example.com

To způsobí @organization být namapován do tohoto registru pro budoucí instalace balíčků specifikovaných podle vzoru @organization/package .

  • Výchozí:""
  • Typ:Řetězec
shrinkwrap

Když false , npm-shrinkwrap.json soubor je během instalace ignorován.

  • Výchozí:true
  • Typ:Boolean
sign-git-tag

Při provádění npm version a pomocí tohoto příznaku -s příznak bude použit během označování k přidání podpisu. Aby to fungovalo, musíte již mít nastavené klíče GPG ve svých konfiguracích git.

  • Výchozí:false
  • Typ:Boolean
tag

Když instalujete balíček z npm a neuvedete verzi, bude místo toho použita tato značka.

  • Výchozí:nejnovější
  • Typ:Řetězec
předpona-verze značky

Znak předřazený verzi balíčku při použití npmversion . To je užitečné, když jiné programy mají konvenci stylu pro verze.

  • Výchozí:"v"
  • Typ:Řetězec

Sítě

https-proxy

Proxy používaný pro odchozí připojení HTTPS. Pokud je nastavena některá z následujících proměnných prostředí, použijí se místo ní:HTTPS_PROXY , https_proxy , HTTP_PROXY , http_proxy .

  • Výchozí:null
  • Typ:url
proxy

Proxy používaný pro odchozí připojení HTTP. Pokud je nastavena některá z následujících proměnných prostředí, použijí se místo ní:HTTP_PROXY , http_proxy .

  • Výchozí:null
  • Typ:url
strict-ssl

To říká npm, zda použít SSL pro připojení k registru přes HTTPS.

  • Výchozí:true
  • Typ:Boolean
user-agent

Nastaví hlavičku požadavku User-Agent pro požadavky HTTP(S).

  • Výchozí:uzel/{process.version} {process.platform} {process.arch}
  • Typ:Řetězec

Registr

načítání-opakování

Počet pokusů npm kontaktovat registr, aby načetl balíček.

  • Výchozí:2
  • Typ:Číslo
faktor-opakování načtení

Konfigurace "faktor" pro modul opakování, který se má použít při načítání balíčků.

  • Výchozí:10
  • Typ:Číslo
fetch-retry-mintimeout

Minimální doba čekání před vypršením časového limitu při načítání balíčků z registru.

  • Výchozí:10 000 (10 sekund)
  • Typ:Číslo (milisekundy)
fetch-retry-maxtimeout

Maximální doba čekání, než vyprší časový limit při načítání balíčků z registru.

  • Výchozí:10 000 (10 sekund)
  • Typ:Číslo (milisekundy)
klíč

Toto je klíč klienta, který se má použít při ověřování pomocí registru.

  • Výchozí:null
  • Typ:Řetězec
registr

Adresa URL registru, který se má použít pro načítání a publikování balíčků.

  • Výchozí:https://registry.npmjs.org/
  • Typ:url
možnosti vyhledávání

Mezerou oddělený seznam možností, které se vždy používají k prohledávání registru.

  • Výchozí:""
  • Typ:Řetězec
vyloučit vyhledávání

Mezerou oddělený seznam limitů, které se vždy používají k prohledávání registru.

  • Výchozí:""
  • Typ:Řetězec
hledání

To označuje, podle kterého pole ve výsledcích by se mělo třídit. Chcete-li změnit pořadí řazení, stačí před něj přidat - .

  • Výchozí:"name"
  • Typ:Řetězec
  • Hodnoty:"name", "-name", "date", "-date", "description", "-description", "keywords", "-keywords"