Node وأول برنامج: تشغّل وتقرا رسالة الخطأ

01 / ملخص الدرس

node -v علشان تتأكد إن Node متسطب، وأول برنامج بـ console.log، والكومنتات، والعمليات الحسابية. وأهم مهارة في الكورس كله: تقرا رسالة الخطأ: اسم الملف، ورقم السطر، ونوع الخطأ، والعلامة اللي بتشاور على المكان.

ضمن مسارباك إند Node.js للإنتاج — من تحت الصفر03 / 122

02 / شرح الدرس مكتوبًا

نص شرح المعلم والكود الذي كتبه ونتيجة تشغيله، بنفس ترتيب الدرس.

أهلًا بيك. أول حاجة: تسطّب Node. بتدخل على موقع nodejs dot org، وتنزّل نسخة LTS، يعني Long Term Support: النسخة اللي بتاخد updates أمان لفترة طويلة، ودي اللي بتشتغل بيها الشركات. وبعد التسطيب، تفتح الـ terminal وتكتب node dash v. node dash v.

main.js

المخرجات

$ node -v && npm -v
v24.14.1
11.11.0

أول سطر رقم إصدار Node، والتاني رقم إصدار npm، وده البرنامج اللي هنسطب بيه المكتبات بعدين. لو طلعلك رقمين زي دول، يبقى كله تمام. لو قالك command not found، يبقى التسطيب ما خلصش، أو محتاج تقفل الـ terminal وتفتحه تاني. دلوقتي البرنامج. أول سطر كومنت، علشان نفتكر. بعدين نطبع كلام. وبعدين حساب: two plus three. وبعدين نفس الحساب بس بين quotes. وآخر سطر قسمة، وعلامة percent، ودي بتجيب باقي القسمة. وخد بالك إن console dot log ممكن ياخد أكتر من حاجة بينهم comma. نشغّل.

main.js

// أي سطر بيبدأ بـ // ده كومنت: Node بيتجاهله
console.log("أهلًا");
console.log(2 + 3);
console.log("2 + 3");
console.log(10 / 4, 10 % 4);

المخرجات

$ node main.js
أهلًا
5
2 + 3
2.5 2

الكومنت ما اتطبعش، Node اتجاهله. two plus three طلعت five، اتحسبت. بس اللي بين الـ quotes اتطبع زي ما هو، لأن ده كلام مش حساب، واسمه string. وعشرة على أربعة: اتنين ونص. وباقي قسمة عشرة على أربعة: اتنين. والـ percent دي هنستخدمها كتير، زي إنك تقسّم الشغل على كام worker. دلوقتي أهم مهارة في الكورس كله. هتغلط كتير، وده طبيعي جدًّا. الفرق بين المبتدئ والمحترف إن المحترف بيقرا رسالة الخطأ كويس. تعالى نغلط بقصد: في السطر التاني نسينا نقفل الـ parenthesis. نشغّل.

main.js

console.log("أهلًا");
console.log("الـ server شغال";
console.log("مش هيوصل هنا");

المخرجات

$ node main.js

/home/you/my-backend/main.js:2
console.log("الـ server شغال";
            ^^^^^^^^^^^^^^^^^

SyntaxError: missing ) after argument list
    at wrapSafe (node:internal/modules/cjs/loader:1743:18)
    at Module._compile (node:internal/modules/cjs/loader:1786:20)
    at Object..js (node:internal/modules/cjs/loader:1943:10)
    at Module.load (node:internal/modules/cjs/loader:1533:32)
    at Module._load (node:internal/modules/cjs/loader:1335:12)
    at wrapModuleLoad (node:internal/modules/cjs/loader:255:19)
    at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5)
    at node:internal/main/run_main_module:33:47

Node.js v24.14.1

بص على الرسالة بهدوء، من فوق لتحت. أول سطر: اسم الملف main dot js، وبعده two dots ورقم السطر: اتنين. وتحتها السطر نفسه، وعلامات caret بتعلّم تحت الجزء اللي فيه المشكلة. وبعدين نوع الخطأ: SyntaxError، يعني الكتابة نفسها غلط، وبعده التفاصيل: missing parenthesis. وخد بالك: ولا سطر اتطبع، حتى أول سطر السليم. لأن SyntaxError بيوقف البرنامج قبل ما يبدأ. نوع تاني: نقفل الـ parenthesis، بس نكتب consol من غير e. نشغّل.

main.js

console.log("أهلًا");
consol.log("الـ server شغال");
console.log("مش هيوصل هنا");

المخرجات

$ node main.js
أهلًا

/home/you/my-backend/main.js:2
consol.log("الـ server شغال");
^

ReferenceError: consol is not defined
    at Object.<anonymous> (/home/you/my-backend/main.js:2:1)
    at Module._compile (node:internal/modules/cjs/loader:1812:14)
    at Object..js (node:internal/modules/cjs/loader:1943:10)
    at Module.load (node:internal/modules/cjs/loader:1533:32)
    at Module._load (node:internal/modules/cjs/loader:1335:12)
    at wrapModuleLoad (node:internal/modules/cjs/loader:255:19)
    at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5)
    at node:internal/main/run_main_module:33:47

Node.js v24.14.1

المرة دي أول سطر اتطبع: أهلًا. وبعدين وقف عند السطر التاني. النوع: ReferenceError، يعني استخدمت اسم مش موجود. التفاصيل: consol is not defined. وتحت فيه سطور بتبدأ بـ at، ودي اسمها stack trace: الطريق اللي البرنامج مشي فيه لحد الخطأ، وأول سطر فيها هو أهم سطر: main dot js، السطر اتنين. يعني ReferenceError بيحصل وقت التشغيل، فاللي قبله بيشتغل عادي. التحدي: هلزقلك برنامج فيه كام خطأ. شغّله، واقرا أول رسالة. صلّح الخطأ اللي بتشاور عليه بس، ونشغّل تاني. وكرر لحد ما يطبع أربع سطور. والتفاصيل وحالات الاختبار في الكومنت تحت البرنامج.

تمرين

صلّح البرنامج خطأ خطأ: شغّل، اقرا الملف والسطر ونوع الخطأ، صلّح، وكرر لحد ما يطبع الأربع سطور.

الحل. أول تشغيل هيقولك SyntaxError في السطر التاني: الـ parenthesis مش مقفولة بعد one twenty plus thirty. بعد ما تقفلها، هيقولك ReferenceError: Console is not defined، لأن Console بـ C كبيرة، و JavaScript بتفرّق بين الكبير والصغير. والسطر الأول من غير semicolon؟ ده مش خطأ، JavaScript بتكمّله لوحدها. نشغّل.

main.js

console.log("تقرير اليوم")
console.log("عدد الـ requests:", 120 + 30);
console.log("متوسط زمن الرد:", 900 / 3, "ms");
console.log("خلصنا");

المخرجات

$ node main.js
تقرير اليوم
عدد الـ requests: 150
متوسط زمن الرد: 300 ms
خلصنا

الأربع سطور زي حالات الاختبار. الدرس الجاي: نحفَظ قيم في متغيرات، ونعرف أنواعها، لأن نص البلاوي في الـ backend سببها نوع غلط: رقم جاي كـ string.

03 / دروس المسار (122)