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

لن يساعدك هذا فقط على تذكره لاحقًا، ولكن إذا قام شخص آخر بمشاهدة كودك، فسيتمكن أيضًا من فهم الرمز.

ميزة أخرى رائعة في التعليقات هي القدرة على التعليقات لإزالة أجزاء من التعليمات البرمجية من التنفيذ عندما تقوم بتصحيح البرامج النصية الخاصة بك.

سيعلمك هذا الدرس كيفية إنشاء نوعين من التعليقات في JavaScript: تعليقات سطر واحد وتعليقات متعددة الأسطر.

يمكن استخدام تعليقات JavaScript لشرح كود JavaScript ، ولجعلها أكثر قابلية للقراءة.

يمكن أيضًا استخدام تعليقات JavaScript لمنع التنفيذ ، عند اختبار كود بديل.

تعليقات سطر واحد:

تبدأ التعليقات ذات السطر الواحد بـ //.

سيتم تجاهل أي نص بين // ونهاية السطر بواسطة JavaScript (لن يتم تنفيذه).

يستخدم هذا المثال تعليقًا من سطر واحد قبل كل سطر رمز:

مثال:

// تغيير العنوان
document.getElementById("myH").innerHTML = "First Page";
 
// تغيير الفقرة
document.getElementById("myP").innerHTML = "first paragraph.";

يستخدم هذا المثال تعليق سطر واحد في نهاية كل سطر لشرح الكود:

مثال:

var x = 4;      //4 أعطها القيمة ,x قم بتعريف
var y = x + 2;  //x + 2 واعطها قيمة, yأعلن عن 

 تعليقات متعددة الأسطر:

تبدأ التعليقات متعددة الأسطر بـ / * وتنتهي بـ * /.

سيتم تجاهل أي نص بين / * و * / بواسطة JavaScript.

يستخدم هذا المثال تعليقًا متعدد الأسطر (جزء تعليق) لشرح الكود:

مثال:

/*
سوف يتغير الرمز أدناه
"myH"=العنوان بالمعرف 
 "myP"=والفقرة بالمعرف 
في صفحة الويب الخاصة بي
*/
document.getElementById("myH").innerHTML = " First Page";
document.getElementById("myP").innerHTML = " first paragraph.";

 استخدام التعليقات لمنع التنفيذ:

يعد استخدام التعليقات لمنع تنفيذ التعليمات البرمجية مناسبًا لاختبار الكود.

تؤدي إضافة // أمام سطر التعليمات البرمجية إلى تغيير خطوط التعليمات البرمجية من سطر قابل للتنفيذ إلى تعليق.

يستخدم هذا المثال // لمنع تنفيذ أحد أسطر الكود:

مثال:

//document.getElementById("myH").innerHTML = "First Page";
document.getElementById("myP").innerHTML = " first paragraph.";

 يستخدم هذا المثال كتلة تعليق لمنع تنفيذ أسطر متعددة:

مثال:

/*
document.getElementById("myH").innerHTML = " First Page";
document.getElementById("myP").innerHTML = "first paragraph.";
*/