npm 6.4 - config

npm-config




npm

أكثر مما تريد معرفته حول تهيئة npm.

وصف

npm تحصل على قيم التكوين الخاصة بها من المصادر التالية ، مرتبة حسب الأولوية:

أعلام سطر الأوامر

وضع - --foo bar في سطر الأوامر يحدد معلمة تكوين foo إلى "bar" . A -- الوسيطة تخبر محلل cli بالتوقف عن قراءة الأعلام. استخدام --flag دون تحديد أي قيمة سيتم تعيين القيمة إلى true .

مثال: --flag1 --flag2 على تعيين معلمات التكوين على true ، في حين --flag1 --flag2 bar بتعيين flag1 على true ، و flag2 . وأخيرًا ، --flag1 --flag2 -- bar تعيين معلمات التكوين على true ، ويتم اعتبار bar كوسيطة أوامر.

متغيرات البيئة

سيتم تفسير أي متغيرات بيئة تبدأ بـ npm_config_ كمعلمة تكوين. على سبيل المثال ، npm_config_foo=bar في البيئة الخاصة بك إلى تعيين معلمة تكوين foo bar . أي تكوينات بيئة لا تعطى قيمة ستعطى قيمة true . تكون قيم التهيئة غير حساسة لحالة الأحرف ، لذلك NPM_CONFIG_FOO=bar بنفس الشكل. ومع ذلك ، يرجى ملاحظة أن داخل npm-scripts npm ستقوم بتعيين متغيرات البيئة الخاصة بها ، وستفضل Node تلك الإصدارات الصغيرة على أي أحرف كبيرة قد تضبطها. للحصول على التفاصيل ، راجع هذه المشكلة .

لاحظ أنك تحتاج إلى استخدام تسطير --allow-same-version بدلاً من الشرطات ، لذا --allow-same-version يصبح --allow-same-version npm_config_allow_same_version=true .

ملفات npmrc

الملفات الأربعة ذات الصلة هي:

  • ملف تهيئة لكل مشروع ( /path/to/my/project/.npmrc )
  • ملف التهيئة لكل مستخدم (افتراضي إلى $HOME/.npmrc ؛ قابل للتكوين عبر خيار CLI - متغير المتغير أو متغير البيئة $NPM_CONFIG_USERCONFIG )
  • ملف التكوين العام (الافتراضي إلى $PREFIX/etc/npmrc ؛ قابل للتكوين عبر خيار CLI --globalconfig أو متغير البيئة $NPM_CONFIG_GLOBALCONFIG )
  • ملف التكوين المدمج في npm ( /path/to/npm/npmrc )

انظر npmrc لمزيد من التفاصيل.

الافتراضي

قم بتشغيل npm config ls -l لمشاهدة مجموعة من معلمات التكوين الداخلة إلى npm ، وتكون افتراضية إذا لم يتم تحديد أي شيء آخر.

اختصارات وأخرى CLI Niceties

يتم تحليل الاختلافات التالية على سطر الأوامر:

  • -v : --version
  • -? ، --help ، -H : -
  • -s ، --silent : --loglevel silent
  • -q ، --quiet : --loglevel warn
  • -d : -d --loglevel info
  • --verbose ، --verbose : --loglevel verbose
  • -ddd : --loglevel silly
  • -g : --global
  • -C : --prefix
  • -l : - --long
  • -m : - --message
  • -p ، - --porcelain : - --parseable
  • -reg : - --registry
  • -f : --force
  • -desc : - --description
  • -S : - --save
  • -P : --save-prod
  • -D : --save-dev
  • -O : --save-optional
  • -B : --save-bundle
  • -E : --save-exact
  • -y : - --yes
  • --yes false : -n --yes false
  • ll وأوامر: ls --long

إذا حل معلمة التوصيف المحددة بشكل لا لبس فيه إلى معلمة تكوين معروفة ، فسيتم توسيعه إلى معلمة التكوين تلك. فمثلا:

npm ls --par
# same as:
npm ls --parseable

إذا تم دمج عدة اختصارات أحادية الأحرف مع بعضها البعض ، وكان الجمع الناتج بشكل لا لبس فيه ليس معلمة تكوين أخرى ، فإنه يتم توسيعه إلى قطعه المكونة المختلفة. فمثلا:

npm ls -gpld
# same as:
npm ls --global --parseable --long --loglevel info

إعدادات التكوين لكل حزمة

عند تشغيل البرامج النصية (راجع npm-scripts ) تتم الكتابة فوق مفاتيح " npm-scripts " في البيئة إذا كان هناك معلمة config من <name>[@<version>]:<key> . على سبيل المثال ، إذا كان package.json يحتوي على هذا:

{ "name" : "foo"
, "config" : { "port" : "8080" }
, "scripts" : { "start" : "node server.js" } }

و server.js هو هذا:

http.createServer(...).listen(process.env.npm_package_config_port)

عندئذ يمكن للمستخدم تغيير السلوك من خلال:

npm config set foo:port 80

انظر package.json لمزيد من المعلومات.

إعدادات التكوين

التمكن من

  • الافتراضي: restricted
  • النوع: الوصول

عند نشر حزم النطاق ، يتم تعيين مستوى الوصول افتراضيًا إلى restricted . إذا كنت تريد أن تكون الحزمة التي تم تحديد نطاقها قابلة للعرض للعرض العام (وقابلة للتثبيت) - --access=public . القيم الصالحة الوحيدة access هي public restricted . دائمًا ما يكون للحزم غير المحظورة مستوى وصول عام.

سماح-نفس النسخة

  • الافتراضي: خطأ
  • اكتب: منطقية

يمنع رمي خطأ عند npm version لتعيين الإصدار الجديد لنفس القيمة npm version الحالية.

دائما المصادقة

  • الافتراضي: خطأ
  • اكتب: منطقية

يتطلب فرض npm دائمًا المصادقة عند الوصول إلى السجل ، حتى بالنسبة لطلبات GET .

أيضا

  • الافتراضي: فارغ
  • اكتب: سلسلة

عندما يكون "dev" أو "development" وتشغيل " npm shrinkwrap المحلي ، npm outdated ، أو npm update ، فهو اسم مستعار لـ --dev .

تدقيق

  • الافتراضي: صحيح
  • اكتب: منطقية

عندما npm install "true" تقارير التدقيق جنبًا إلى جنب مع تشغيل npm install إلى السجل الافتراضي وجميع السجالت التي تم تكوينها للنطاقات. راجع الوثائق الخاصة بـ npm-audit للحصول على تفاصيل حول ما يتم تقديمه.

المصادقة من نوع

  • الافتراضي: 'legacy'
  • النوع: 'legacy' و 'sso' و 'saml' و 'oauth'

ما هي استراتيجية المصادقة التي يجب استخدامها مع adduser / login .

  • الافتراضي: true
  • اكتب: منطقية

يخبر npm لإنشاء symlinks (أو الحزم .cmd على Windows) للملفات التنفيذية الحزمة.

اضبط على false حتى لا تفعل ذلك. يمكن استخدام هذا للتغلب على حقيقة أن بعض أنظمة الملفات لا تدعم الروابط ، حتى على أنظمة Unix ظاهريًا.

المتصفح

  • الإفتراضي: OS X: "open" ، Windows: "start" ، آخرون: "xdg-open"
  • اكتب: سلسلة

المتصفح الذي يتم استدعائه بواسطة الأمر npm docs لفتح مواقع الويب.

كاليفورنيا

  • الافتراضي: شهادة CA CA
  • النوع: سلسلة أو صفيف أو فارغ

شهادة توقيع المرجع المصدق موثوق لاتصالات SSL إلى التسجيل. يجب أن تكون القيم بتنسيق PEM (يطلق Windows عليه "Base-64 encoded X.509 (.CER)") مع استبدال الخطوط الجديدة بالسلسلة "\ n". فمثلا:

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

اضبط على null للسماح فقط للمُسجلين "المعروفين" ، أو إلى شهادة CA محددة بأن تثق في ذلك المرجع المحدد للتوقيع فقط.

يمكن الوثوق في المراجع المصدقة متعددة عن طريق تحديد صفيف من الشهادات:

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

انظر أيضا التكوين strict-ssl .

cafile

  • الافتراضي: null
  • النوع: المسار

مسار إلى ملف يحتوي على شهادة توقيع واحدة أو عدة شهادات من مراجع التصديق. على غرار الإعداد ca ، ولكنه يسمح بتعدد عناصر CA ، بالإضافة إلى أنه يتم تخزين معلومات CA في ملف على القرص.

مخبأ

  • الإفتراضي: Windows: %AppData%\npm-cache ، Posix: ~/.npm
  • النوع: المسار

موقع دليل ذاكرة التخزين المؤقت في npm. انظر npm-cache

ذاكرة التخزين المؤقت قفل قديمة

  • الافتراضي: 60000 (1 دقيقة)
  • نوع الرقم

يعتبر عدد ms قبل lockfiles مجلد التخزين المؤقت تالفة.

ذاكرة التخزين المؤقت قفل المحاولة

  • الافتراضي: 10
  • نوع الرقم

عدد مرات إعادة المحاولة للحصول على تأمين على lockfiles مجلد التخزين المؤقت.

ذاكرة التخزين المؤقت قفل الانتظار

  • الافتراضي: 10000 (10 ثوانٍ)
  • نوع الرقم

عدد ms للانتظار حتى انتهاء صلاحية ملفات قفل ذاكرة التخزين المؤقت.

مخبأ ماكس

  • الافتراضي: إنفينيتي
  • نوع الرقم

تم الإيقاف : تم إيقاف هذا الخيار لصالح --prefer-online .

--cache-max=0 عبارة عن اسم مستعار لـ --prefer-online .

ذاكرة التخزين المؤقت دقيقة

  • الافتراضي: 10
  • نوع الرقم

تم الإيقاف : تم إيقاف هذا الخيار لصالح --prefer-offline .

--cache-min=9999 (or bigger) هو اسم مستعار من أجل --prefer-offline .

سيرت

  • الافتراضي: null
  • اكتب: سلسلة

شهادة العميل لتمرير عند الوصول إلى التسجيل. يجب أن تكون القيم بتنسيق PEM (يطلق Windows عليه "Base-64 encoded X.509 (.CER)") مع استبدال الخطوط الجديدة بالسلسلة "\ n". فمثلا:

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

ليس المسار إلى ملف شهادة (ولا يوجد خيار "certfile").

CIDR

  • الافتراضي: null
  • اكتب: سلسلة ، صفيف ، لاغية

هذه قائمة من عناوين CIDR لاستخدامها عند تكوين رموز وصول محدودة مع الأمر npm token create .

اللون

  • الافتراضي: صحيح
  • النوع: منطقي أو "always"

إذا كانت خاطئة ، فلن تعرض الألوان أبدًا. إذا كان "always" يعرض اللون دائمًا. إذا كان الأمر صحيحًا ، فقم فقط بطباعة رموز الألوان لواصف ملف tty.

يمكن أيضًا تغيير هذا الخيار باستخدام البيئة: يتم تعطيل الألوان عند تعيين متغير البيئة NO_COLOR على أي قيمة.

عمق

  • الافتراضي: إنفينيتي
  • نوع الرقم

عمق الذهاب عند npm ls ، npm cache ls ، و npm outdated .

بالنسبة npm outdated ، سيتم التعامل مع إعداد Infinity على أنه 0 لأن ذلك يعطي معلومات أكثر فائدة. لإظهار الحالة القديمة لجميع الحزم والمعالين ، استخدم قيمة عددية كبيرة ، على سبيل المثال ، npm outdated --depth 9999

وصف

  • الافتراضي: صحيح
  • اكتب: منطقية

اعرض الوصف في npm search

ديف

  • الافتراضي: خطأ
  • اكتب: منطقية

تثبيت dev-dependencies مع الحزم.

ركض جاف

  • الافتراضي: خطأ
  • اكتب: منطقية

يشير إلى أنك لا تريد أن تقوم npm بإجراء أي تغييرات وأنه يجب عليها فقط الإبلاغ عما كانت ستفعله. يمكن تمرير ذلك إلى أي من الأوامر التي تقوم بتعديل التثبيت المحلي ، على سبيل المثال ، install ، update ، uninstall ، uninstall . لا يتم تكريم هذا الأمر في الوقت الحالي من خلال الأوامر المتعلقة بالشبكة ، على سبيل المثال ، dist-tags ، owner ، publish ، إلخ.

محرر

  • الافتراضي: متغير بيئة EDITOR إذا تم تعيينه ، أو "vi" على Posix ، أو "notepad" على Windows.
  • النوع: المسار

الأمر لتشغيل npm edit أو npm config edit .

محرك الصارم

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا تم تعيينها على true ، فسترفض npm بعناد تثبيت (أو حتى التفكير في تثبيت) أي حزمة تدعي أنها غير متوافقة مع إصدار Node.js الحالي.

فرض

  • الافتراضي: خطأ
  • اكتب: منطقية

يجعل أوامر مختلفة أكثر قوة.

  • فشل البرنامج النصي دورة حياة لا يمنع التقدم.
  • نشر clobbers الإصدارات المنشورة سابقا.
  • يتخطى ذاكرة التخزين المؤقت عند طلب من التسجيل.
  • يمنع الشيكات ضد ملفات non-npm clobbering.

المحاولة-جلب

  • الافتراضي: 2
  • نوع الرقم

تكوين "إعادة المحاولة" لوحدة retry لاستخدامها عند جلب الحزم من السجل.

جلب-إعادة المحاولة عامل

  • الافتراضي: 10
  • نوع الرقم

تكوين "عامل" لوحدة retry لاستخدامها عند جلب الحزم.

جلب-إعادة المحاولة-mintimeout

  • الافتراضي: 10000 (10 ثوانٍ)
  • نوع الرقم

تهيئة "minTimeout" لوحدة retry لاستخدامها عند جلب الحزم.

جلب-إعادة المحاولة-maxtimeout

  • الافتراضي: 60000 (1 دقيقة)
  • نوع الرقم

تهيئة "maxTimeout" لوحدة retry لاستخدامها عند جلب الحزم.

بوابة

  • الافتراضي: "git"
  • اكتب: سلسلة

الأمر المستخدم لأوامر git. إذا تم تثبيت git على الكمبيوتر ، ولكن ليس في PATH ، PATH بتعيين هذا إلى المسار الكامل إلى git binary.

بوابة العلامة الإصدار

  • الافتراضي: true
  • اكتب: منطقية

npm version علامة على الالتزام عند استخدام الأمر npm version .

السنانير ارتكاب

  • الافتراضي: true
  • اكتب: منطقية

تشغيل git hooks عند استخدام الأمر npm version .

عالمي

  • الافتراضي: خطأ
  • اكتب: منطقية

يعمل في الوضع "العمومي" ، بحيث يتم تثبيت هذه الحزم في مجلد prefix بدلاً من دليل العمل الحالي. انظر npm-folders لمزيد من الاختلافات في السلوك.

  • يتم تثبيت الحزم في المجلد {prefix}/lib/node_modules ، بدلاً من دليل العمل الحالي.
  • يتم ربط ملفات bin بـ {prefix}/bin
  • ترتبط صفحات man بـ {prefix}/share/man

globalconfig

  • الافتراضي: {prefix} / etc / npmrc
  • النوع: المسار

ملف التهيئة المراد قراءتها لخيارات التهيئة العامة.

على غرار العالمي

  • الافتراضي: خطأ
  • اكتب: منطقية

يتسبب npm لتثبيت الحزمة في مجلد node_modules المحلي بنفس التخطيط الذي يستخدمه مع المجلد node_modules . لن تظهر إلا node_modules المباشرة في node_modules وسيتم node_modules كل شيء يعتمد عليه في مجلدات node_modules . هذا من الواضح أن القضاء على بعض deduping. إذا تم استخدامها مع legacy-bundling legacy-bundling ، فسيتم تفضيل legacy-bundling legacy-bundling .

مجموعة

  • الافتراضي: GID للعملية الحالية
  • النوع: سلسلة أو رقم

المجموعة المراد استخدامها عند تشغيل برامج نصية حزمة في الوضع العمومي كمستخدم الجذر.

عنوان

  • الافتراضي: "npm"
  • اكتب: سلسلة

السلسلة التي تبدأ كل إخراج سجل التصحيح.

HTTPS بالوكالة

  • الافتراضي: فارغ
  • النوع: رابط

وكيل لاستخدام لطلبات https المنتهية ولايته. إذا تم تعيين متغيرات البيئة HTTPS_PROXY أو https_proxy أو HTTP_PROXY أو http_proxy ، سيتم تكريم إعدادات الوكيل بواسطة مكتبة request الأساسية.

إذا كان موجودا

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا كانت true ، لن تخرج npm برمز خطأ عندما يتم استدعاء run-script لبرنامج نصي لم يتم تعريفه في قسم scripts لـ package.json . يمكن استخدام هذا الخيار عندما يكون من المرغوب تشغيل نص برمجي اختياري عند وجوده وفشله إذا فشل البرنامج النصي. وهذا مفيد ، على سبيل المثال ، عند تشغيل البرامج النصية التي قد تنطبق فقط على بعض البنيات في إعداد CI عامًا.

تجاهل-prepublish

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا كان هذا صحيحًا ، فلن تقوم npm بتشغيل البرامج النصية الخاصة بنظام النشر المسبق.

تجاهل النصية

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا كان true ، لا يقوم npm بتشغيل البرامج النصية المحددة في ملفات package.json.

الحرف الأول وحدة

  • الافتراضي: ~ / .npm-init.js
  • النوع: المسار

الوحدة النمطية التي سيتم تحميلها بواسطة الأمر npm init . راجع الوثائق الخاصة init-package-json لمزيد من المعلومات ، أو npm-init .

التهيئة المؤلف اسم

  • الافتراضي: ""
  • اكتب: سلسلة

يجب استخدام القيمة npm init للقيمة npm init افتراضيًا لاسم مؤلف الحزمة.

التهيئة مؤلف البريد الإلكتروني

  • الافتراضي: ""
  • اكتب: سلسلة

يجب استخدام القيمة npm init للقيمة npm init بشكل افتراضي للبريد الإلكتروني للمؤلف.

الحرف الأول في تأليف-رابط

  • الافتراضي: ""
  • اكتب: سلسلة

يجب استخدام القيمة npm init للقيمة npm init الرئيسية للمؤلف.

الحرف الأول ترخيص

  • الافتراضي: "ISC"
  • اكتب: سلسلة

يجب استخدام القيمة npm init للقيمة npm init بشكل افتراضي لترخيص الحزمة.

الحرف الأول الإصدار

  • الافتراضي: "1.0.0"
  • اكتب: semver

القيمة التي يجب أن تستخدمها npm init بشكل افتراضي لرقم إصدار الحزمة ، إذا لم يتم تعيينها بالفعل في package.json.

سلمان

  • الافتراضي: خطأ
  • اكتب: منطقية

ما إذا كان سيتم إخراج بيانات JSON أم لا ، بدلاً من الإخراج العادي.

هذه الميزة تجريبية في الوقت الحالي ، ولم يتم تنفيذ بنية بيانات الإخراج للعديد من الأوامر في JSON حتى الآن ، أو عرضة للتغيير. فقط المخرجات من npm ls --json و npm search --json صالحة حاليًا.

مفتاح

  • الافتراضي: null
  • اكتب: سلسلة

مفتاح العميل لتمرير عند الوصول إلى التسجيل. يجب أن تكون القيم بتنسيق PEM مع استبدال الخطوط الجديدة بالسلسلة "\ n". فمثلا:

key="-----BEGIN PRIVATE KEY-----\nXXXX\nXXXX\n-----END PRIVATE KEY-----"

ليس المسار إلى ملف مفتاح (ولا يوجد خيار "ملف المفتاح").

إرث تجميع

  • الافتراضي: خطأ
  • اكتب: منطقية

يتسبب npm لتثبيت الحزمة بحيث يمكن تثبيت حزمة npm السابقة على 1.4 ، مثل تلك التي تم تضمينها في العقدة 0.8. هذا يزيل جميع deduping التلقائي. إذا تم استخدام هذا الخيار مع global-style فسيتم تفضيل هذا الخيار.

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا كان هذا صحيحًا ، فستثبت عمليات التثبيت المحلية إذا كان هناك حزمة مثبتة عالميًا مناسبة.

لاحظ أن هذا يعني أن التثبيتات المحلية يمكن أن تتسبب في تثبيت الأشياء في المساحة العامة في نفس الوقت. يتم الارتباط فقط إذا تم استيفاء أحد الشرطين التاليين:

  • الحزمة غير مثبتة بالفعل على مستوى العالم ، أو
  • الإصدار المثبت بشكل عام مطابق للإصدار الذي يتم تثبيته محليًا.

محلي-عنوان

  • الافتراضي: غير محدد
  • النوع: عنوان IP

عنوان IP للواجهة المحلية لاستخدامه عند إجراء اتصالات بسجل npm. يجب أن يكون IPv4 في إصدارات عقدة قبل 0.12.

تسجيل مستوى

  • الافتراضي: "إشعار"
  • اكتب: سلسلة
  • القيم: "صامت" ، "خطأ" ، "تحذير" ، "إشعار" ، "http" ، "توقيت" ، "معلومات" ، "مطوّل" ، "سخيفة"

ما مستوى السجلات للإبلاغ عنها. عند الفشل ، تتم كتابة جميع السجلات إلى npm-debug.log في دليل العمل الحالي.

يتم عرض أي سجلات بمستوى أعلى من الإعداد. الافتراضي هو "إشعار".

logstream

  • الافتراضي: process.stderr
  • النوع: تيار

هذا هو الدفق الذي تم تمريره إلى الوحدة النمطية npmlog في وقت التشغيل.

لا يمكن تعيينه من سطر الأوامر ، ولكن إذا كنت تستخدم npm برمجياً ، فقد ترغب في إرسال السجلات إلى مكان آخر غير stderr.

إذا تم ضبط إعدادات color على true ، فسيستقبل هذا البث الملون إذا كان TTY.

سجلات ماكس

  • الافتراضي: 10
  • نوع الرقم

الحد الأقصى لعدد ملفات السجل لتخزينها.

طويل

  • الافتراضي: خطأ
  • اكتب: منطقية

عرض المعلومات الموسعة في npm ls و npm search .

maxsockets

  • الافتراضي: 50
  • نوع الرقم

الحد الأقصى لعدد الاتصالات المستخدمة لكل منشأ (مجموعة البروتوكول / المضيف / المنفذ). تم تمريره إلى Agent http المستخدم لإجراء الطلب.

رسالة

  • الافتراضي: "٪ s"
  • اكتب: سلسلة

ارتكاب الرسالة التي يستخدمها npm version عند إنشاء نسخة الالتزام.

سيتم استبدال أي "٪ s" في الرسالة برقم الإصدار.

مقاييس-التسجيل

  • الافتراضي: قيمة registry (التي تعد افتراضية "https://registry.npmjs.org/")
  • اكتب: سلسلة

السجل الذي تريد إرسال مقاييس cli إليه إذا كانت send-metrics صحيحة.

عقدة خيارات

  • الافتراضي: فارغ
  • اكتب: سلسلة

خيارات للمرور عبر Node.js عبر متغير بيئة NODE_OPTIONS . هذا لا يؤثر على كيفية تنفيذ npm نفسها لكنه يؤثر على كيفية استدعاء البرامج النصية لدورة الحياة.

عقدة نسخة

  • الافتراضي: process.version
  • النوع: مقسم أو خطأ

إصدار العقدة لاستخدامه عند التحقق من خريطة engines الحزمة.

لا الوكيل

  • الافتراضي: فارغ
  • اكتب: سلسلة أو صفيف

سلسلة مفصولة بفواصل أو مجموعة من امتدادات النطاق التي لا ينبغي استخدام وكيل لها.

غير متصل على الانترنت

  • الافتراضي: خطأ
  • اكتب: منطقية

فرض وضع غير متصل بالشبكة: لن يتم إجراء أية طلبات على الشبكة أثناء التثبيت. للسماح لـ CLI بتعبئة بيانات ذاكرة التخزين المؤقت المفقودة ، راجع --prefer-offline .

ONLOAD النصي

  • الافتراضي: خطأ
  • النوع: المسار

وحدة العقدة التي require() عند تحميل npm. مفيد للاستخدام البرمجي.

فقط

  • الافتراضي: فارغ
  • اكتب: سلسلة

عند "dev" أو "development" وتشغيل npm install محلي بدون أية وسائط ، يتم تثبيت devDependencies (وتبعياتها) فقط.

عندما يكون "dev" أو "development" وتشغيل npm ls المحلي ، npm outdated ، أو npm update ، هو اسم مستعار لـ --dev .

عند "prod" أو "production" وتشغيل npm install محلي بدون أي وسيطات ، يتم تثبيت non-devDependencies (وتوابعها فقط).

عندما يكون "prod" أو "production" وتشغيل npm ls المحلي ، npm outdated ، أو npm update ، يعد اسمًا مستعارًا --production .

اختياري

  • الافتراضي: صحيح
  • اكتب: منطقية

محاولة تثبيت الحزم في كائن optionalDependencies . لاحظ أنه في حالة فشل تثبيت هذه الحزم ، لا يتم إحباط عملية التثبيت العامة.

مكتب المدعي العام

  • الافتراضي: فارغ
  • نوع الرقم

هذه كلمة مرور لمرة واحدة من مصادقة ثنائية. هناك حاجة عند نشر أو تغيير أذونات الحزمة مع npm access .

حزمة قفل

  • الافتراضي: صحيح
  • اكتب: منطقية

إذا تم package-lock.json على "false" ، package-lock.json ملفات package-lock.json عند التثبيت. سيؤدي هذا أيضًا إلى منع كتابة package-lock.json إذا كان save صحيحًا.

عندما يتم تعطيل تأمين حزم الحزمة ، سيتم أيضًا تعطيل التقليم التلقائي للوحدات الدخيلة. لإزالة الوحدات الدخيلة مع قفل الحزمة تعطيل استخدام npm prune .

هذا الخيار هو اسم مستعار لـ --shrinkwrap .

حزمة قفل فقط

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا تم package-lock.json على "true" ، فسيتم تحديث package-lock.json ، بدلاً من التحقق من node_modules وتنزيل التبعيات.

parseable

  • الافتراضي: خطأ
  • اكتب: منطقية

نتائج parseable الإخراج من الأوامر التي تكتب إلى الإخراج القياسي. npm search ، سيكون هذا تنسيق جدول مفصول بعلامات جدولة.

تفضل-متواجد حاليا

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا كان هذا صحيحًا ، فسيتم تجاوز عمليات التحقق من البيانات المخزنة مؤقتًا ، ولكن سيتم طلب بيانات مفقودة من الخادم. لفرض وضع عدم الاتصال الكامل ، استخدم - غير --offline .

هذا الخيار يكافئ بشكل فعال --cache-min=9999999 .

تفضل على الانترنت

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا كان هذا صحيحًا ، فسيتم فرض التحقق من البيانات المخزنة مؤقتًا ، مما يجعل CLI يبحث عن التحديثات فورًا حتى مع بيانات الحزمة الجديدة.

اختصار

  • الافتراضي: راجع npm-folders
  • النوع: المسار

الموقع لتثبيت العناصر العمومية. في حالة التعيين على سطر الأوامر ، فإنه يفرض تشغيل الأوامر غير العامة في المجلد المحدد.

إنتاج

  • الافتراضي: خطأ
  • اكتب: منطقية

اضبط على true للتشغيل في وضع "الإنتاج".

  1. لم يتم تثبيت devDependencies في المستوى الأعلى عند تشغيل npm install المحلي بدون أية وسائط.
  2. عيّن NODE_ENV = "الإنتاج" للنصوص البرمجية لدورة الحياة.

تقدم

  • الافتراضي: true ، ما لم يتم تعيين TRAVIS أو CI env vars.
  • اكتب: منطقية

عند الضبط على true ، سيعرض npm شريط تقدم أثناء العمليات المكثفة للوقت ، إذا كانت process.stderr هي TTY.

اضبط على false لإيقاف شريط التقدم.

الوكيل

  • الافتراضي: فارغ
  • النوع: رابط

وكيل لاستخدام لطلبات http المنتهية ولايته. إذا تم تعيين متغيرات البيئة http_proxy أو http_proxy ، سيتم تكريم إعدادات الوكيل بواسطة مكتبة request الأساسية.

يقرأ فقط

  • الافتراضي: خطأ
  • اكتب: منطقية

يُستخدم هذا لتمييز رمز مميز غير قادر على النشر عند تكوين رموز وصول محدودة مع الأمر npm token create .

إعادة بناء-حزمة

  • الافتراضي: صحيح
  • اكتب: منطقية

إعادة بناء التبعية المجمعة بعد التثبيت.

سجل

عنوان URL الأساسي لسجل حزمة npm.

التراجع

  • الافتراضي: صحيح
  • اكتب: منطقية

إزالة التثبيتات الفاشلة.

حفظ

  • الافتراضي: صحيح
  • اكتب: منطقية

احفظ الحزم المثبتة في ملف package.json كتركيبات.

عند استخدامه مع الأمر npm rm ، فإنه يزيله من كائن dependencies .

يعمل فقط إذا كان هناك بالفعل ملف package.json موجود.

حفظ-حزمة

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا كان سيتم حفظ حزمة في وقت التثبيت باستخدام - --save ، --save-dev ، أو --save-optional ، ثم أيضا وضعها في قائمة bundleDependencies .

عند استخدامها مع الأمر npm rm ، تقوم بإزالتها من قائمة ItemsDependencies.

حفظ-همز

  • الافتراضي: خطأ
  • اكتب: منطقية

تأكد من حفظ الحزمة في dependencies وجه التحديد. يكون هذا مفيدًا إذا كانت الحزمة موجودة بالفعل في devDependencies أو devDependencies ، ولكنك ترغب في نقلها لتكون نقطة إنتاج. هذا هو السلوك الافتراضي أيضًا إذا كان --save صحيحًا ، ولا --save-dev أو --save-optional --save-dev أو --save-optional يكون صحيحًا.

حفظ ديف

  • الافتراضي: خطأ
  • اكتب: منطقية

احفظ الحزم المثبتة في ملف package.json كـ devDependencies .

عند استخدامه مع الأمر npm rm ، فإنه يزيله من كائن devDependencies .

يعمل فقط إذا كان هناك بالفعل ملف package.json موجود.

حفظ-بالضبط

  • الافتراضي: خطأ
  • اكتب: منطقية

سيتم تكوين التبعيات المحفوظة في package.json باستخدام --save أو --save-dev أو --save-optional مع إصدار دقيق بدلاً من استخدام مشغل نطاق semver الافتراضي في npm.

حفظ-اختياري

  • الافتراضي: خطأ
  • اكتب: منطقية

احفظ الحزم المثبتة في ملف package.json كإعتمادات اختيارية.

عند استخدامه مع الأمر npm rm ، فإنه يزيله من كائن devDependencies .

يعمل فقط إذا كان هناك بالفعل ملف package.json موجود.

حفظ بادئة

  • الافتراضي: '^'
  • اكتب: سلسلة

قم بتكوين كيفية تثبيت إصدارات الحزم على ملف package.json عبر - --save أو --save-dev على مسبوق.

على سبيل المثال ، إذا كانت الحزمة تحتوي على الإصدار 1.2.3 ، يتم تعيين إصدارها افتراضيًا إلى ^1.2.3 والذي يسمح npm config set save-prefix='~' ثانوية لهذه الحزمة ، ولكن بعد npm config set save-prefix='~' إلى ~1.2.3 الذي يسمح فقط ترقيات التصحيح.

نطاق

  • الافتراضي: نطاق المشروع الحالي ، إن وجد ، أو ""
  • اكتب: سلسلة

إقران عملية بنطاق لسجل ذو نطاق محدد. مفيد عند تسجيل الدخول إلى سجل خاص لأول مرة: npm login [email protected] --registry=registry.organization.com ، مما سيؤدي إلى تعيين npm login [email protected] --registry=registry.organization.com إلى السجل للتثبيت المستقبلي للحزم المحددة وفقًا لـ نمط @organization/package .

السيناريو قذيفة

  • الافتراضي: null
  • النوع: المسار

تعمل shell المستخدم للنصوص البرمجية مع الأمر npm run .

البرامج النصية أرفقت عقدة مسار

  • الافتراضي: "warn-only"
  • النوع: منطقي ، "auto" أو "warn-only"

إذا تم تعيينها على " true ، قم بإضافة الدليل الذي توجد فيه node التنفيذية القابلة للتنفيذ إلى متغير بيئة PATH عند تشغيل البرامج النصية ، حتى إذا كان هذا يعني أن npm ستقوم باستدعاء node قابلة للتنفيذ من تلك التي تعمل بها.

إذا تم false على " false ، PATH تقم أبدًا بتعديل PATH بذلك.

إذا تم تعيينها على "warn-only" ، "warn-only" تقم بتعديل PATH ولكن قم بطباعة تحذير إذا كان npm يعتقد أنك قد ترغب في تشغيلها مع true ، على سبيل المثال ، لأن node القابلة للتنفيذ في PATH ليست هي npm تم استدعاؤها.

في حالة npm على " auto ، قم بإضافة هذا الدليل فقط إلى متغير بيئة التشغيل PATH إذا كانت node قابلة للتنفيذ والتي تم استدعاء npm لها npm تلك الموجودة أولاً على PATH .

searchexclude

  • الافتراضي: ""
  • اكتب: سلسلة

خيارات مفصولة في الفضاء تحد من نتائج البحث.

searchopts

  • الافتراضي: ""
  • اكتب: سلسلة

الخيارات المنفصلة في الفضاء والتي يتم تمريرها دائمًا للبحث.

searchlimit

  • الافتراضي: 20
  • نوع الرقم

عدد العناصر لتحديد نتائج البحث. لن تنطبق على الإطلاق على عمليات البحث القديمة.

searchstaleness

  • الافتراضي: 900 (15 دقيقة)
  • نوع الرقم

عمر ذاكرة التخزين المؤقت بالثواني ، قبل إجراء طلب تسجيل آخر في حالة استخدام نقطة نهاية البحث القديمة.

مقاييس-ترسل

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا كان هذا صحيحًا ، فسيتم الإبلاغ عن مقاييس النجاح / الفشل في السجل المخزّن في metrics-registry . تحتوي هذه الطلبات على عدد مرات التشغيل الناجحة والفاشلة لـ npm CLI والفترة الزمنية overwhich التي تم جمعها. لا يتم تضمين معلومات التعريف في هذه الطلبات.

الصدف

  • الافتراضي: متغير بيئة SHELL ، أو "bash" على Posix ، أو "cmd" على Windows
  • النوع: المسار

قذيفة لتشغيل npm explore .

العبوة

  • الافتراضي: صحيح
  • اكتب: منطقية

إذا تم npm-shrinkwrap.json ملفات npm-shrinkwrap.json عند التثبيت. سيؤدي هذا أيضًا إلى منع كتابة npm-shrinkwrap.json إذا كان save صحيحًا.

هذا الخيار هو اسم مستعار لـ --package-lock .

تسجيل الدخول بوابة العلامة

  • الافتراضي: خطأ
  • اكتب: منطقية

إذا تم تعيينها على "true" ، npm version الأمر npm version علامة على الإصدار باستخدام -s لإضافة توقيع.

لاحظ أن git يتطلب منك إعداد مفاتيح GPG في تهيئات git لكي يعمل هذا بشكل صحيح.

SSO-الاقتراع التردد

  • الافتراضي: 500
  • نوع الرقم

عند استخدامها مع auth-type SSO ، يتم تكوين مدى انتظام التسجيل في حين يقوم المستخدم بإكمال المصادقة.

SSO من نوع

  • الافتراضي: "oauth"
  • النوع: "oauth" أو "saml" أو null

إذا - --auth-type=sso ، نوع نوع الدخول الموحّد المراد استخدامه.

صارم-SSL

  • الافتراضي: صحيح
  • اكتب: منطقية

ما إذا كان سيتم إجراء التحقق من صحة مفتاح طبقة المقابس الآمنة أم لا عند تقديم طلبات إلى السجل عبر https.

انظر أيضا التكوين ca .

بطاقة

  • الافتراضي: الأحدث
  • اكتب: سلسلة

إذا طلبت من npm تثبيت حزمة وعدم إخبارها بنسخة محددة ، فستقوم بتثبيت العلامة المحددة.

أيضًا العلامة التي يتم إضافتها إلى الحزمة @ version المحددة بواسطة الأمر npm tag ، إذا لم يتم وضع علامة واضحة.

الوسم الإصدار البادئة

  • الافتراضي: "v"
  • اكتب: سلسلة

في حالة التعيين ، يغير البادئة المستخدمة عند وضع علامة على إصدار جديد عند إجراء زيادة إصدار باستخدام npm-version . لإزالة البادئة تمامًا ، اضبطها على السلسلة الفارغة: "" .

نظرًا لأن الأدوات الأخرى قد تعتمد على الاتفاقية التي تبدو عليها علامات الإصدار npm مثل v1.0.0 ، فاستخدم هذه الخاصية فقط إذا كانت ضرورية للغاية . على وجه الخصوص ، استخدم الرعاية عند تجاوز هذا الإعداد للحزم العامة.

توقيت

  • الافتراضي: false
  • اكتب: منطقية

إذا كان الأمر صحيحًا ، npm-debug سجل npm-debug إلى _logs ومعلومات التوقيت إلى _timing.json ، سواء في ذاكرة التخزين المؤقت. _timing.json عبارة عن قائمة محددة بفواصل من كائنات JSON. يمكنك مشاهدته بسرعة باستخدام سطر أوامر json هذا: json -g < ~/.npm/_timing.json .

تمة

  • الافتراضي: متغير البيئة TMPDIR ، أو "/ tmp"
  • النوع: المسار

مكان تخزين الملفات والمجلدات المؤقتة. يتم حذف جميع الملفات المؤقتة على النجاح ، ولكن تترك وراءها في حالة الفشل لأغراض الطب الشرعي.

يونيكود

  • الافتراضي: false على windows ، صحيح على أنظمة mac / unix مع لغة Unicode
  • اكتب: منطقية

عند الضبط على true ، يستخدم npm أحرف unicode في إخراج الشجرة. عند false ، يستخدم أحرف ascii لرسم الأشجار.

غير آمنة-بيرم

  • الافتراضي: خطأ إذا كان يعمل كجذر ، صحيح خلاف ذلك
  • اكتب: منطقية

اضبط على true لمنع التبديل UID / GID عند تشغيل البرامج النصية للحزمة. إذا تم التعيين بشكل صريح على false ، فسيخفق التثبيت كمستخدم غير أساسي.

استعمال

  • الافتراضي: خطأ
  • اكتب: منطقية

اضبط لإظهار مخرجات الاستخدام القصير (مثل الإخراج -H) بدلاً من المساعدة الكاملة عند القيام npm-help .

المستعمل

  • الافتراضي: "لا أحد"
  • النوع: سلسلة أو رقم

UID لتعيين عند تشغيل البرامج النصية الحزمة كجذر.

userconfig

  • الافتراضي: ~ / .npmrc
  • النوع: المسار

موقع إعدادات التكوين على مستوى المستخدم.

umask

  • الافتراضي: 022
  • النوع: سلسلة رقمية أوكتارية في النطاق 0000..0777 (0..511)

قيمة "umask" لاستخدامها عند إعداد وضع إنشاء الملف على الملفات والمجلدات.

يتم إعطاء المجلدات والملفات التنفيذية الوضع الذي يتم 0777 مقابل هذه القيمة. يتم إعطاء ملفات أخرى وضع 0666 مقنع مقابل هذه القيمة. وبالتالي ، فإن القيم الافتراضية هي 0755 و 0644 على التوالي.

وكيل المستخدم

  • الافتراضي: عقدة / {process.version} {process.platform} {process.arch}
  • اكتب: سلسلة

لتعيين وكيل مستخدم لرأس الطلب

الإصدار

  • الافتراضي: خطأ
  • النوع: منطقي

إذا كان هذا صحيحًا ، فاخرج إصدار npm وأخرج بنجاح.

فقط ذات الصلة عند تحديد صراحة على سطر الأوامر.

إصدارات

  • الافتراضي: خطأ
  • النوع: منطقي

إذا كان هذا صحيحًا ، فقم بإصدار إصدار npm بالإضافة إلى خريطة process.versions للعقدة ، ثم قم بإنهاء بنجاح.

فقط ذات الصلة عند تحديد صراحة على سطر الأوامر.

مشاهد

  • الافتراضي: "رجل" على Posix ، "المتصفح" على نظام التشغيل Windows
  • النوع: المسار

البرنامج المستخدم لعرض محتوى المساعدة.

اضبط على "browser" لعرض محتوى تعليمات HTML في متصفح الويب الافتراضي.

أنظر أيضا