process.argv
قراءة معاملات سطر الأوامر process.argv
process.argv مصفوفة نصية تحوي كل معاملات سطر الأوامر التي شُغّل بها البرنامج، أول عنصرين منها ثابتان دائمًا.
process.argv مصفوفة: العنصر بالفهرس 0 مسار ملف node التنفيذي، والعنصر بالفهرس 1 مسار ملف السكربت المُشغَّل، وكل ما بعدهما (من الفهرس 2 فصاعدًا) هي المعاملات الفعلية التي كتبها المستخدم بسطر الأوامر.
تُستخدم غالبًا لبناء أدوات CLI بسيطة تقرأ خيارات المستخدم مباشرة دون مكتبات خارجية.
الصياغة
process.argv // Array<string>
📄 مثال
// node greet.js Ali --loud
console.log(process.argv);
// [
// '/usr/local/bin/node',
// '/path/to/greet.js',
// 'Ali',
// '--loud'
// ]
const name = process.argv[2];
console.log(`مرحبًا ${name}`);أهم المعاملات
| المعامل | الوظيفة |
|---|---|
| argv[0] | مسار ملف node التنفيذي نفسه |
| argv[1] | مسار ملف السكربت الجاري تشغيله |
| argv[2..] | المعاملات الفعلية التي أدخلها المستخدم |
💡 نصائح عملية
- أول عنصرين ثابتان دائمًا — معاملاتك الفعلية تبدأ من argv[2] لا argv[0]
- لأدوات CLI معقّدة (خيارات بصيغة --name=value، اختصارات) استخدم مكتبة متخصصة بدل تحليل argv يدويًا
⚠️ أخطاء شائعة
- قراءة argv[0] أو argv[1] على أنهما أول معامل أدخله المستخدم — هذا خطأ شائع جدًا عند كتابة أول أداة CLI
خصائص ذات صلة
🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار NODEJS الكامل بالعربي.