| النوع | الصيغة | الاستخدام |
|---|---|---|
| تعليق سطري | // نص | ملاحظة قصيرة على سطر واحد |
| تعليق متعدد الأسطر | /* نص */ | شرح طويل أو تعطيل كود |
التعليقات (Comments) هي أسطر نصية يكتبها المطور داخل الكود لتوضيح ما يفعله جزء معين، ويتجاهلها المتصفح تماماً عند التنفيذ — لا تؤثر على سير البرنامج إطلاقاً. أهميتها تكمن في جعل الكود مفهوماً لك بعد أشهر من كتابته، ولزملائك في العمل عند مراجعة أو تطوير الكود لاحقاً.
توجد نوعان من التعليقات في جافاسكريبت: التعليق السطري (Single-line Comment) ويبدأ بشرطتين مائلتين //، ويمتد حتى نهاية السطر فقط. والتعليق متعدد الأسطر (Multi-line Comment) الذي يبدأ بـ /* وينتهي بـ */، ويمكن أن يمتد لعدة أسطر، وهو مفيد لكتابة شروحات طويلة أو تعطيل جزء كبير من الكود مؤقتاً أثناء التصحيح.
من أفضل الممارسات كتابة تعليقات تشرح "لماذا" تم اتخاذ قرار برمجي معين، وليس فقط "ماذا" يفعل السطر — لأن الكود الجيد غالباً يوضح بنفسه ماذا يفعل، لكنه لا يوضح سبب اختيار هذا الحل تحديداً. الإفراط في التعليقات البديهية (مثل // هذا متغير اسمه العمر فوق let العمر = 25) يُعتبر ممارسة سيئة لأنه يُشتت القارئ.
تُستخدم التعليقات أيضاً بشكل شائع كأداة تصحيح مؤقتة (Debugging) لتعطيل سطر أو مجموعة أسطر دون حذفها، وهذا يُسمى "Commenting Out"، مما يسمح للمطور بتجربة الكود بدون جزء معين واستعادته لاحقاً بسهولة.
| 1 | // هذا تعليق سطري واحد |
| 2 | |
| 3 | /* |
| 4 | هذا تعليق |
| 5 | متعدد الأسطر |
| 6 | يمكن أن يمتد لعدة سطور |
| 7 | */ |
| 8 | |
| 9 | let س = 10; // تعليق في نهاية السطر |
مثال 1: تعليق يشرح "لماذا" وليس "ماذا"
| 1 | // حساب الضريبة على السعر |
| 2 | function حساب_الضريبة(سعر) { |
| 3 | // نسبة الضريبة ثابتة حالياً 15% حسب قانون الدولة |
| 4 | const نسبة_الضريبة = 0.15; |
| 5 | return سعر * نسبة_الضريبة; |
| 6 | } |
مثال 2: استخدام التعليقات لتعطيل كود مؤقتاً
| 1 | /* |
| 2 | تعطيل هذا الجزء مؤقتاً أثناء اختبار الميزة الجديدة |
| 3 | سيُعاد تفعيله بعد انتهاء الاختبار |
| 4 | */ |
| 5 | // function ميزة_قديمة() { |
| 6 | // console.log("النسخة القديمة"); |
| 7 | // } |
| 8 | |
| 9 | function ميزة_جديدة() { |
| 10 | console.log("النسخة الجديدة قيد الاختبار"); |
| 11 | } |