عرض مصدر Node.js/synopsis

<noinclude>{{DISPLAYTITLE:طريقة الاستعمال وتشغيل الأمثلة في Node.js}}</noinclude>
== البنية العامة ==
<syntaxhighlight lang="shell">
node [options] [V8 options] [script.js | -e "script" | - ] [arguments]
</syntaxhighlight>راجع رجاءً توثيق [[Node.js/cli|خيارات سطر الأوامر]] للمزيد من المعلومات عن الخيارات والطرائق التي يمكن استعمالها لتشغيل السكربتات وتنفيذها مع Node.js.

== تشغيل الأمثلة ==
سنشرح مثالًا عن إنشاء خادم ويب باستعمال Node.js يُظهِر العبارة 'مرحبًا بالعالم!' في المتصفح.

تبدأ الأوامر المستعملة في هذا المثال بالمحرف <code>$</code> أو <code><</code> وذلك لمحاكاة كيفيَّة ظهورها في طرفيَّة المستخدم، لذا لا تضف هذين المحرفين إلى الأوامر عند نسخها واستعمالها. توجد الكثير من الدروس والأمثلة التي تتبع الطريقة نفسها، إذ يُستعمَل المحرف <code>$</code> أو المحرف <code><</code> للإشارة إلى الأوامر الاعتياديَّة التي يستطيع جميع المستخدمين تنفيذها، ويُستعمَل المحرف <code>#</code> للإشارة إلى الأوامر التي يتطلب تنفيذها صلاحيات مدير النظام (administrator).

انتبه إلى أنَّ الأسطر التي لا تبدأ بإحدى المحارف السابقة تُمثِّل عادةً مخرجات الأوامر التي تسبقها.

قبل الخوض بتفاصيل أعمق، هل Node.js مثبَّتةٌ على نظامك؟ إن لم تكن Node.js مثبتةً على حاسوبك، فارجع إلى [https://nodejs.org/en/download/package-manager/ هذا الدليل] واتبع خطوات تنزيل وتثبيت Node.js.

أنشئ بعد ذلك مجلدًّا فارغًا باسم projects مثلًا وانتقل إليه. إن كان لديك مجلدٌ سابقٌ يحتوي على مشاريعك، فانتقل إليه مباشرةً.

استعمل الأمرين التاليين في بيئة لينكس وماك لإنشاء المجلَّد والانتقال إليه:<syntaxhighlight lang="shell">
$ mkdir ~/projects
$ cd ~/projects
</syntaxhighlight>أو استعمل الأمرين التاليين في موجه أوامر ويندوز (CMD):<syntaxhighlight lang="shell">
> mkdir %USERPROFILE%\projects
> cd %USERPROFILE%\projects
</syntaxhighlight>أو إن كنت تستعمل الصدفة PowerShell في ويندوز، فاستخدم الأمرين التاليين:<syntaxhighlight lang="powershell">
> mkdir $env:USERPROFILE\projects
> cd $env:USERPROFILE\projects
</syntaxhighlight>الخطوة التالية هي إنشاء ملف داخل المجلَّد projects الذي أنشأناه (أو أي مجلَّد آخر تختاره) يدعى hello-world.js الذي سيحتوي على الشيفرة التي سنكتبها لاحقًا.

'''ملاحظة''': يُعدُّ استخدام الشرِطَة العادية (-) والسفلية (_) من العادات الحسنة لفصل أسماء الملفات التي تزيد عن كلمة واحدة.

افتح الملف hello-worl.js باستعمال محرر النصوص المفضل لديك وانسخ الشيفرة التالية والصقها فيه:<syntaxhighlight lang="javascript">
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}/`);
});
</syntaxhighlight>احفظ الملف ثمَّ انتقل إلى سطر الأوامر لديك واكتب الأمر التالي:<syntaxhighlight lang="shell">
$ node hello-world.js
</syntaxhighlight>يجب أن تظهر في الطرفيَّة لديك نتيجة شبيه بالنتيجة التالية تشير إلى أنَّ خادم Node.js بدأ بالعمل:<syntaxhighlight lang="text">
Server running at http://127.0.0.1:3000/
</syntaxhighlight>افتح الآن أيَّ متصفح ويب لديك وأدخل العنوان <code><nowiki>http://127.0.0.1:3000</nowiki></code> فيه. يجب أن يُظهِر المتصفح العبارة "مرحبًا بالعالم!" التي تشير إلى أنَّ الخادم يعمل بشكل صحيح.

تستطيع تشغيل معظم الأمثلة في توثيق Node.js بطريقةٍ مماثلةٍ لما سبق.

== مصادر ==
* [https://nodejs.org/dist/latest-v10.x/docs/api/synopsis.html#synopsis_usage صفحة Usage في توثيق Node.js الرسمي.]
[[تصنيف:Node.js|{{SUBPAGENAME}}]]