مقدمة
في الدروس السابقة تعلمنا كيف تعمل أساسيات JavaScript:
- المتغيرات لحفظ البيانات.
- أنواع البيانات لمعرفة طبيعة المعلومات.
- العمليات لمعالجة البيانات.
- إدخال وإخراج البيانات للتفاعل مع المستخدم.
لكن مع مرور الوقت، عندما تبدأ بكتابة برامج أكبر، ستواجه مشكلة مهمة:
ماذا لو عدت إلى الكود بعد عدة أشهر ولم تتذكر سبب كتابة جزء معين؟
أو ماذا لو عمل معك مبرمج آخر ويحتاج إلى فهم طريقة عمل البرنامج؟
هنا تظهر أهمية التعليقات (Comments).
التعليقات هي وسيلة يستخدمها المبرمج لكتابة ملاحظات داخل الكود تساعد البشر على فهم البرنامج، لكنها لا تؤثر على طريقة عمله.
---
ما هي التعليقات؟
التعليق هو نص يكتبه المبرمج داخل ملف JavaScript بهدف الشرح، وتقوم اللغة بتجاهله أثناء تنفيذ البرنامج.
أي أن JavaScript ترى التعليق كمعلومة موجهة للمبرمج فقط، وليس كأمر يجب تنفيذه.
---
لماذا نستخدم التعليقات؟
قد يبدو البرنامج واضحًا عندما يكون صغيرًا.
لكن في المشاريع الحقيقية قد يحتوي الكود على:
- مئات أو آلاف الأسطر.
- وظائف كثيرة.
- ملفات متعددة.
- فريق كامل من المطورين.
في هذه الحالة تساعد التعليقات على:
- شرح وظيفة أجزاء معينة من الكود.
- توضيح الأفكار المعقدة.
- تسهيل تعديل البرنامج مستقبلًا.
- مساعدة الآخرين على فهم المشروع.
---
مثال من الحياة اليومية
تخيل أنك تبني منزلًا.
المهندس قد يضع ملاحظات على المخطط مثل:
"هنا مكان الكهرباء"
أو:
"هذا الجدار يحتاج إلى نوع معين من المواد"
هذه الملاحظات لا تبني المنزل بنفسها، لكنها تساعد من يقرأ المخطط على فهمه.
التعليقات في البرمجة تعمل بالطريقة نفسها.
---
هل JavaScript تنفذ التعليقات؟
لا.
عند تشغيل البرنامج، تتجاهل JavaScript التعليقات تمامًا.
فالكمبيوتر يهتم بالأوامر البرمجية فقط، أما التعليقات فهي موجهة للإنسان الذي يقرأ الكود.
وهذا يعني أن حذف التعليقات غالبًا لا يغير نتيجة تشغيل البرنامج، لكنه قد يجعل فهمه أصعب.
---
لماذا يحتاج المبرمج المحترف إلى التعليقات؟
عندما تعمل على مشروع صغير، قد تتذكر كل شيء.
لكن تخيل أنك طورت موقعًا كبيرًا، ثم عدت إليه بعد فترة طويلة.
قد تجد جزءًا من الكود وتقول:
"لماذا كتبت هذا السطر بهذه الطريقة؟"
هنا يأتي دور التعليق.
فهو يشرح الفكرة أو السبب وراء كتابة الكود، وليس فقط ما يفعله السطر.
---
هل نضع تعليقًا على كل سطر؟
لا.
هذه من العادات السيئة عند المبتدئين.
ليس الهدف أن يصبح الكود مليئًا بالنصوص.
فمثلًا، تعليق يشرح أمرًا واضحًا جدًا قد يجعل الكود أكثر إزعاجًا للقراءة.
الأفضل هو كتابة التعليقات عندما تكون هناك حاجة حقيقية للشرح.
---
الفرق بين الكود والتعليق
الكود:
- ينفذه الحاسوب.
- يغير البيانات.
- ينتج نتائج.
التعليق:
- لا ينفذه الحاسوب.
- لا يغير البرنامج.
- يشرح الفكرة للمبرمج.
معرفة هذا الفرق تساعدك على كتابة برامج أكثر تنظيمًا.
---
أين تستخدم التعليقات؟
يمكن استخدامها في:
- شرح وظيفة جزء من البرنامج.
- توضيح سبب استخدام طريقة معينة.
- كتابة ملاحظات أثناء تطوير المشروع.
- تنظيم الملفات الكبيرة.
- ترك تعليمات لأعضاء الفريق.
---
أخطاء شائعة عند المبتدئين
من الأخطاء الشائعة:
- كتابة تعليقات كثيرة بلا فائدة.
- كتابة تعليق قديم لا يطابق الكود بعد تعديله.
- استخدام التعليقات لإخفاء كود سيئ بدل تحسينه.
التعليق الجيد يضيف قيمة، ولا يكرر ما هو واضح.
---
لماذا تعد التعليقات جزءًا من احتراف البرمجة؟
البرمجة ليست فقط جعل الحاسوب ينفذ الأوامر.
بل هي أيضًا كتابة كود يستطيع الإنسان فهمه وتطويره.
ولهذا يهتم المبرمجون المحترفون بتنظيم الكود وكتابة التعليقات عند الحاجة.
---
ملخص الدرس
تعلمنا أن التعليقات (Comments) هي ملاحظات داخل كود JavaScript تساعد المبرمجين على فهم البرنامج وتنظيمه، وأنها لا يتم تنفيذها من قبل اللغة. كما عرفنا أن استخدامها الصحيح يجعل المشاريع الكبيرة أسهل في القراءة والصيانة والعمل الجماعي.
في الدرس السادس سنتعرف على التحويل بين أنواع البيانات (Type Casting)، وسنفهم كيف تغير JavaScript نوع البيانات من شكل إلى آخر، ولماذا نحتاج إلى ذلك أثناء بناء البرامج.