كتابة أول سكربت Node.js وتشغيله عبر سطر الأوامر (CLI)


مرحباً بكم في هذا الدرس العملي! اليوم سنتعلم كيفية كتابة أول سكربت Node.js بسيط وتشغيله مباشرة من سطر الأوامر (CLI).

الخطوة 1: تهيئة بيئة العمل وإنشاء ملف السكربت

أولاً، تأكد من تثبيت Node.js على جهازك. يمكنك التحقق من ذلك بفتح سطر الأوامر وكتابة node -v و npm -v. بعد ذلك، قم بإنشاء مجلد جديد لمشروعك وداخله ملف JavaScript. سنسميه app.js.

ملاحظة تقنية: استخدام .js هو الامتداد القياسي لملفات JavaScript. Node.js يستخدم محرك V8 لتشغيل هذه الملفات خارج المتصفح.

داخل ملف app.js، سنبدأ بكتابة رسالة ترحيب بسيطة.

// app.js

// استخدام الدالة console.log لطباعة رسالة إلى سطر الأوامر (الكونسول).
// هذه هي الطريقة الأساسية لإخراج البيانات في Node.js.
console.log("مرحباً بك في عالم Node.js!");

الخطوة 2: إضافة تفاعل بسيط - متغيرات وتواريخ

لنجعل السكربت أكثر ديناميكية. سنضيف متغيراً لتخزين اسم، ونقوم بطباعة التاريخ والوقت الحاليين. هذا يوضح كيفية التعامل مع المتغيرات والدوال المدمجة في JavaScript.

// app.js

// تعريف متغير لتخزين اسم المستخدم.
const userName = "المبرمج المحترف";

// استخدام الدالة console.log لطباعة رسالة ترحيب مع استخدام المتغير.
console.log(<code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">مرحباً بك يا ${userName} في عالم Node.js!</code>);

// إنشاء كائن Date للحصول على التاريخ والوقت الحاليين.
const now = new Date();

// طباعة التاريخ والوقت الحاليين بتنسيق سهل القراءة.
console.log(<code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">التاريخ والوقت الحالي: ${now.toLocaleString()}</code>);

الخطوة 3: تشغيل السكربت عبر سطر الأوامر (CLI)

بعد كتابة السكربت، حان الوقت لتشغيله. افتح سطر الأوامر (Terminal أو Command Prompt)، وانتقل إلى المجلد الذي أنشأت فيه ملف app.js باستخدام أمر cd.

ثم، قم بتشغيل السكربت باستخدام أمر node متبوعاً باسم الملف:

node app.js

ملاحظة تقنية: الأمر node هو أمر CLI الذي يقوم بتشغيل بيئة Node.js ويأخذ ملف JavaScript كمدخل لتنفيذه.

الكود النهائي الكامل

إليك السكربت كاملاً، جاهزاً للنسخ واللصق في ملف app.js الخاص بك:

// app.js

// استخدام الدالة console.log لطباعة رسالة ترحيب إلى سطر الأوامر (الكونسول).
// هذه هي الطريقة الأساسية لإخراج البيانات في Node.js.
console.log("مرحباً بك في عالم Node.js!");

// تعريف متغير لتخزين اسم المستخدم.
const userName = "المبرمج المحترف";

// استخدام الدالة console.log لطباعة رسالة ترحيب مع استخدام المتغير.
// نستخدم هنا "قوالب السلاسل النصية" (Template Literals) باستخدام العلامة <code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;"> (backtick)
// لتضمين المتغيرات بسهولة داخل السلاسل النصية.
console.log(</code>مرحباً بك يا ${userName} في هذا الدرس!<code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">);

// إنشاء كائن Date للحصول على التاريخ والوقت الحاليين.
const now = new Date();

// طباعة التاريخ والوقت الحاليين بتنسيق سهل القراءة.
// الدالة toLocaleString() تقوم بتحويل التاريخ إلى سلسلة نصية بتنسيق محلي.
console.log(</code>التاريخ والوقت الحالي: ${now.toLocaleString()}`);

النتيجة المتوقعة

عند تشغيل السكربت node app.js في سطر الأوامر، ستشاهد مخرجات مشابهة لما يلي (التاريخ والوقت سيتغيران بناءً على وقت التشغيل):

مرحباً بك في عالم Node.js!
مرحباً بك يا المبرمج المحترف في هذا الدرس!
التاريخ والوقت الحالي: ٧‏/٥‏/٢٠٢٤ ٩:٣٠:٠٠ ص

تهانينا! لقد قمت بتشغيل أول سكربت Node.js بنجاح. هذا هو الأساس الذي ستبني عليه مشاريعك المستقبلية.