تجمع البرامج النصية npm مجموعة من الأوامر الطرفية التي يمكنك استخدامها لأتمتة المهام في مشروع JavaScript. كما أنها توفر طريقة متسقة لتشغيل الأوامر في بيئات مختلفة.
يمكنك إعداد برامج نصية npm في ملف package.json وتشغيلها في سطر الأوامر واستخدام مجموعة واسعة من الخيارات لتهيئة سلوكها.
إعداد البرامج النصية npm في ملف package.json
تقوم عادةً بتعريف البرامج النصية npm في ملف package.json ، يقع في جذر مشروع JavaScript الخاص بك. هذا ليس أمرًا ضروريًا حيث يمكنك تنفيذ البرامج النصية من ملفات أخرى ، ولكن package.json يسهل الوصول إلى البرامج النصية وإدارتها.
لاحظ أنك بحاجة إلى تثبيت npm و Node في بيئة التطوير الخاصة بك للمتابعة. فيما يلي بعض المقالات المفيدة:
- كيف قم بتثبيت Node.js و npm على نظام Windows.
- كيف قم بتثبيت Node.js و npm على Ubuntu.
لإعداد برنامج نصي npm في package.json ، اتبع الخطوات التالية:
- انتقل إلى جذر مشروعك.
- قم بتشغيل init على الجهاز. سيطرح عليك الأمر بعض الأسئلة حول مشروعك. أجبهم لإنشاء ملف package.json مناسب.
الحرف الأول npm - في ملف package.json ، حدد موقع مجال البرامج النصية. هنا ، يمكنك إضافة اسم البرنامج النصي والأمر الذي يجب تشغيله كأزواج مفتاح / قيمة. على سبيل المثال ، يقوم البرنامج النصي أدناه ، المسمى hello-world ، بطباعة "Hello world" في المحطة عند التشغيل.
{
"نصوص": {
"مرحبا بالعالم": "صدى صوت \\"مرحبا بالعالم\\""
}
}
فيما يلي بعض البرامج النصية الشائعة لمشاريع JavaScript:
- يبدأ: هذا البرنامج النصي يبدأ خادم التطوير. على سبيل المثال ، في مشروع Node ، يمكن ذلك قم بتشغيل الخادم باستخدام nodemon.
- يبني: يولد رمز الإنتاج لتطبيقك وقد يستخدم أداة مثل webpack لتصغير الكود وتجميعه.
- امتحان: يقوم هذا البرنامج النصي بإجراء الاختبارات المحددة في مشروعك. قد يتم تشغيل إطار اختبار مثل Jest.
- الوبر: يقوم برنامج lint النصي بتشغيل أداة فحص مثل ESLint للتحقق من وجود أخطاء محتملة في التعليمات البرمجية.
- يشاهد: يراقب هذا البرنامج النصي التعليمات البرمجية المصدر للتغييرات ثم يقوم بتشغيل أحد الأوامر. من المفيد إعادة تشغيل الاختبارات أو إعادة بناء التطبيق عند تغيير الكود.
- نشر: يقوم بتشغيل أمر ينشر التطبيق في البيئة المحددة مثل الإنتاج أو التدريج.
مخطوطات ما قبل وبعد
يدعم npm البرامج النصية السابقة واللاحقة. تعمل البرامج النصية المسبقة قبل برنامج نصي محدد بينما يتم تشغيل البرامج النصية اللاحقة بعد ذلك. يمكنك إنشاء نصوص مسبقة ونشر لأي نص برمجي ، ما عليك سوى إضافة بادئة "pre" أو "post" إلى اسم البرنامج النصي الخاص بك.
على سبيل المثال ، يوجد أدناه نصوص برمجية للاختبار التمهيدي والبعدي والتي سيتم تشغيلها قبل نص الاختبار وبعده على التوالي.
{
"نصوص": {
"اختبار أولي": "npm run lint",
"امتحان": "دعابة",
"الاختبار اللاحق": "npm run build"
}
}
تشغيل البرامج النصية npm من package.json
بمجرد إضافة برنامج نصي npm إلى package.json ، يمكنك تشغيله باستخدام الأمر npmrun.
هنا بناء الجملة:
تشغيل npm
على سبيل المثال ، لتشغيل نص البداية المحدد مسبقًا ، استخدم:
بدء تشغيل npm
يمكنك تنفيذ الأمر npmrun من تلقاء نفسه ، للحصول على قائمة بجميع البرامج النصية المتاحة في المشروع. إليك بعض الأمثلة على الإخراج:
البرامج النصية المتوفرة في [email protected] عبر `npm run-script`:
مرحبا بالعالم
صدى "Hello world"
يسرد اسم البرنامج النصي والأمر الذي يتم تشغيله.
استخدام أوامر الاختزال لتشغيل البرامج النصية المضمنة
يدعم npm العديد من البرامج النصية المضمنة التي يمكنك تشغيلها باستخدام أوامر مختصرة. على سبيل المثال ، لتشغيل برنامج نصي npm باسم start ، يمكنك استخدام npm start ، بدلاً من npm run start.
هذا أكثر ملاءمة وأسرع من كتابة الأمر الكامل. تتضمن البرامج النصية المضمنة الأخرى التي يمكنك تشغيلها مثل هذا "اختبار" و "إيقاف" و "إعادة تشغيل".
تشغيل عدة برامج نصية npm
يمكنك تشغيل عدة برامج نصية npm بطريقتين:
- بالتتابع
- بالتوازي
إذا كنت تستخدم Linux ، أو أي نظام آخر شبيه بـ Unix ، فيمكنك استخدام المعيار طرق تشغيل أوامر متعددة في وقت واحد.
لتشغيل عدة برامج نصية npm بشكل تسلسلي ، استخدم && ، على سبيل المثال:
npm تشغيل اختبار بدء && npm
لتشغيل عدة نصوص برمجية npm في الاستخدام المتوازي & ، على سبيل المثال:
npm تشغيل الخادم & npm تشغيل العميل
في بيئات غير UNIX ، يمكنك استخدام الأمر npm-run-all أو الحزمة npm المتزامنة.
باستخدام npm-run-all:
npm-run-all - عميل خادم موازي
يتم استخدامها بشكل متزامن في package.json.
"نصوص": {
"ديف": "بشكل متزامن \\"npm تشغيل الخادم \\" \\"npm تشغيل العميل \\"",
}
لاحظ أنك تحتاج إلى تثبيت الحزم npm-run-all و Concurrently قبل استخدامها.
استكشاف أخطاء البرنامج النصي الشائعة لـ Npm وإصلاحها
فيما يلي بعض الأخطاء الشائعة التي قد تواجهها عند تشغيل البرامج النصية npm:
- npm يخطئ! نص مفقود - يحدث هذا الخطأ عندما لا تكون قد حددت النص الذي تحاول تشغيله في ملف package.json. تأكد من كتابة اسم النص البرمجي بشكل صحيح وأنه محدد في حقل البرامج النصية لملف package.json.
- تم رفض الإذن - يحدث هذا الخطأ عندما لا يكون لديك إذن لتشغيل برنامج نصي ، لذا تأكد من حصولك على الأذونات الصحيحة.
- التبعيات المفقودة - يحدث هذا الخطأ عندما يستخدم البرنامج النصي حزمة غير مثبتة. استخدم أداة مثل ديبتشيك للتحقق من التبعيات المفقودة من package.json ثم قم بتثبيتها باستخدام تثبيت npm.
- طلب مجهول - يحدث هذا الخطأ عادةً عند تشغيل برنامج نصي مخصص كأمر npm مضمّن. تأكد من استخدام ملفات تشغيل npm أو تشغيل البرنامج النصي npm عند تشغيل البرامج النصية المخصصة.
استخدام متغيرات البيئة في البرامج النصية npm
متغيرات البيئة تسمح لك بتمرير المعلومات دون الحاجة إلى ترميزها. لاستخدام متغيرات البيئة في برنامج نصي npm ، يمكنك استخدام الامتداد عبر حزمة npm. تساعدك هذه الأداة في تعيين متغير بيئي في أي بيئة.
ابدأ بتشغيل هذا الأمر على الجهاز لتثبيته كاعتمادية dev:
npm أنا حفظ -D cross-env
ثم استخدمه في البرنامج النصي الخاص بك مثل هذا:
{
"نصوص": {
"يبني": "cross-env NODE_ENV = حزمة ويب للإنتاج"
}
}
هنا ، يعين التقاطع المتقاطع متغير NODE_ENV على "الإنتاج".
تمرير وسيطات سطر الأوامر إلى البرامج النصية
يمكنك تمرير وسيطات سطر الأوامر إلى برنامج نصي npm باستخدام شرطتين "-" بعد اسم البرنامج النصي. على سبيل المثال ، يقوم الأمر التالي بتشغيل البرنامج النصي التجريبي باستخدام وسيطة watch:
تشغيل اختبار npm - - مشاهدة
يمكنك أيضًا إرسال وسيطة سطر أوامر إلى برنامج نصي npm مثل هذا:
npm قم بتشغيل المنفذ الخاص بي --PORT = 3000
ثم الوصول إليه في البرنامج النصي على النحو التالي.
"نصوص": {
"المنفذ الخاص بي": "صدى صوت \\"المنفذ: $ npm_config_PORT \\""
}
في نظام Windows ، استخدم هذا:
"نصوص": {
"المنفذ الخاص بي": "صدى صوت \\"المنفذ:٪ npm_config_PORT٪ \\""
}
يجب أن يقوم البرنامج النصي بطباعة "Port: 3000" عند تشغيله.
لماذا استخدام البرامج النصية npm؟
يمكنك إضافة برامج نصية إلى package.json ، وتشغيلها في سطر الأوامر ، واستخدام الخطافات السابقة واللاحقة ، وتمرير وسيطات الخط ومتغيرات البيئة إليها.
تعد البرامج النصية npm طريقة فعالة لأتمتة المهام في مشاريع JavaScript. يمكنهم تحسين سير عملك وتوفير الوقت من خلال تزويدك بأوامر متسقة لتشغيل مهام متعددة.