تكتب سكربتات تتلقّى مُعطيات باستخدام process.argv، وتقرأ متغيرات البيئة، وتُرجِع رمز خروج.
افتح هذا الدرس في Kodokonأنت تستخدم بالفعل برامج سطر الأوامر: node وnpm وgit وما إلى ذلك. يقبل كل منها مُعطيات (arguments)، وهي الكلمات المكتوبة بعد اسمه، والتي تغيّر سلوكه. لنكتب برنامجنا الخاص. تكشف Node الكائن العام process، الذي يصف البرنامج قيد التشغيل حاليًا - وقد صادفته مع process.version. إن خاصيته process.argv مصفوفة تحتوي على: المسار إلى Node عند الفهرس 0؛ والمسار إلى سكربتك عند الفهرس 1؛ والمُعطيات التي كتبها المستخدم فعليًا بدءًا من الفهرس 2.
console.log(process.argv);
const args = process.argv.slice(2);
console.log("Your arguments:", args);مصدر ثانٍ للمعلومات: متغيرات البيئة. وهي أزواج اسم/قيمة يوفّرها النظام للبرنامج عند إطلاقه. تُستخدم للإعداد: مفتاح API سري، أو وضع تصحيح الأخطاء، أو عنوان قاعدة بيانات، وما إلى ذلك. تقرأها في الكائن process.env. إن المتغير المفقود هو undefined: خطّط دائمًا لقيمة افتراضية، باستخدام المُعامِل ?? مثلًا.
const level = process.env.LOG_LEVEL ?? "info";
console.log("Log level:", level);LOG_LEVEL=debug node config.jsعندما ينتهي برنامج ما، فإنه يُرجِع رمز خروج إلى النظام: وهو رقم يلخّص كيف سارت الأمور. اصطلاح عالمي: يعني 0 "النجاح"، وتشير أي قيمة أخرى إلى خطأ - وهذا ما تتحقق منه الأدوات والسكربتات الأخرى لمعرفة ما إذا كان كل شيء قد نجح. توقف process.exit(1) السكربت فورًا برمز 1. استخدم أيضًا console.error لرسائل الخطأ: فهي تكتب في مخرَج الخطأ (stderr)، وهو قناة منفصلة عن المخرَج العادي. لنجمع كل هذا في سكربت كامل.
const name = process.argv[2];
if (!name) {
console.error("Usage: node greet.js <name>");
process.exit(1);
}
console.log(`Hello, ${name}!`);