طريقة الاستعمال وتشغيل الأمثلة في Node.js
البنية العامة
node [options] [V8 options] [script.js | -e "script" | - ] [arguments]
راجع رجاءً توثيق خيارات سطر الأوامر للمزيد من المعلومات عن الخيارات والطرائق التي يمكن استعمالها لتشغيل السكربتات وتنفيذها مع Node.js.
تشغيل الأمثلة
سنشرح مثالًا عن إنشاء خادم ويب باستعمال Node.js يُظهِر العبارة 'مرحبًا بالعالم!' في المتصفح.
تبدأ الأوامر المستعملة في هذا المثال بالمحرف $ أو < وذلك لمحاكاة كيفيَّة ظهورها في طرفيَّة المستخدم، لذا لا تضف هذين المحرفين إلى الأوامر عند نسخها واستعمالها. توجد الكثير من الدروس والأمثلة التي تتبع الطريقة نفسها، إذ يُستعمَل المحرف $ أو المحرف < للإشارة إلى الأوامر الاعتياديَّة التي يستطيع جميع المستخدمين تنفيذها، ويُستعمَل المحرف # للإشارة إلى الأوامر التي يتطلب تنفيذها صلاحيات مدير النظام (administrator).
انتبه إلى أنَّ الأسطر التي لا تبدأ بإحدى المحارف السابقة تُمثِّل عادةً مخرجات الأوامر التي تسبقها.
قبل الخوض بتفاصيل أعمق، هل Node.js مثبَّتةٌ على نظامك؟ إن لم تكن Node.js مثبتةً على حاسوبك، فارجع إلى هذا الدليل واتبع خطوات تنزيل وتثبيت Node.js.
أنشئ بعد ذلك مجلدًّا فارغًا باسم projects مثلًا وانتقل إليه. إن كان لديك مجلدٌ سابقٌ يحتوي على مشاريعك، فانتقل إليه مباشرةً.
استعمل الأمرين التاليين في بيئة لينكس وماك لإنشاء المجلَّد والانتقال إليه:
$ mkdir ~/projects
$ cd ~/projects
أو استعمل الأمرين التاليين في موجه أوامر ويندوز (CMD):
> mkdir %USERPROFILE%\projects
> cd %USERPROFILE%\projects
أو إن كنت تستعمل الصدفة PowerShell في ويندوز، فاستخدم الأمرين التاليين:
> mkdir $env:USERPROFILE\projects
> cd $env:USERPROFILE\projects
الخطوة التالية هي إنشاء ملف داخل المجلَّد projects الذي أنشأناه (أو أي مجلَّد آخر تختاره) يدعى hello-world.js الذي سيحتوي على الشيفرة التي سنكتبها لاحقًا.
ملاحظة: يُعدُّ استخدام الشرِطَة العادية (-) والسفلية (_) من العادات الحسنة لفصل أسماء الملفات التي تزيد عن كلمة واحدة.
افتح الملف hello-worl.js باستعمال محرر النصوص المفضل لديك وانسخ الشيفرة التالية والصقها فيه:
const http = require('http');
const hostname = '127.0.0.1';
const port = 3000;
const server = http.createServer((req, res) => {
res.statusCode = 200;
res.setHeader('Content-Type', 'text/plain');
res.end('مرحبًا بالعالم!\n');
});
server.listen(port, hostname, () => {
console.log(`Server running at http://${hostname}:${port}/`);
});
احفظ الملف ثمَّ انتقل إلى سطر الأوامر لديك واكتب الأمر التالي:
$ node hello-world.js
يجب أن تظهر في الطرفيَّة لديك نتيجة شبيه بالنتيجة التالية تشير إلى أنَّ خادم Node.js بدأ بالعمل:
Server running at http://127.0.0.1:3000/
افتح الآن أيَّ متصفح ويب لديك وأدخل العنوان http://127.0.0.1:3000 فيه. يجب أن يُظهِر المتصفح العبارة "مرحبًا بالعالم!" التي تشير إلى أنَّ الخادم يعمل بشكل صحيح.
تستطيع تشغيل معظم الأمثلة في توثيق Node.js بطريقةٍ مماثلةٍ لما سبق.