Ú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
odkaz
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"