6- التعليقات في جافاسكربت (JavaScript Comments)

التعليقات هي ملاحظات أو توضيحات تكتب داخل كود جافاسكربت ولكن يتم تجاهلها من قبل المتصفح ولا تؤثر على تنفيذ البرنامج. تستخدم التعليقات لعدة أغراض منها:

• شرح وتوضيح أجزاء من الكود، مما يجعله أسهل فهمًا لك وللآخرين الذين يقرأون الكود لاحقًا.
• تعطيل تنفيذ أجزاء معينة من الكود مؤقتًا، وهذا مفيد أثناء اختبار خيارات مختلفة للكود.

أنواع التعليقات في جافاسكربت:

هناك نوعان رئيسيان من التعليقات في جافاسكربت:

تعليقات السطر الواحد (Single Line Comments):

بدأ التعليقات أحادية السطر برمزين //.أي نص يوضع بعد // وحتى نهاية السطر يعتبر تعليقًا ويتم تجاهله من قبل المتصفح.

// Change heading:
document.getElementById("myH").innerHTML = "My First Page";

// Change paragraph:
document.getElementById("myP").innerHTML = "My first paragraph.";

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

let x = 5;      // Declare x, give it the value of 5
let y = x + 2;  // Declare y, give it the value of x + 2

• تعليقات متعددة السطور (Multi-Line Comments):
  • تبدأ التعليقات متعددة السطور برمزين /* وتنتهي برمزين */.أي نص يوضع بين /* و */ يعتبر تعليقًا ويتم تجاهله بغض النظر عن عدد الأسطر.
  على سبيل المثال:JavaScriptlet x = 5; /* إعلان المتغير x وتعليمه القيمة 5 */ let y

/*
The code below will change
the heading with id = "myH"
and the paragraph with id = "myP"
in my web page:
*/
document.getElementById("myH").innerHTML = "My First Page";
document.getElementById("myP").innerHTML = "My first paragraph.";

استخدام التعليقات لمنع التنفيذ (Using Comments to Prevent Execution)

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

يمكن منع تنفيذ سطر من الكود بإضافة // في بداية السطر.

على سبيل المثال:

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

في هذا المثال، قمنا باضافة // أمام السطر الأول مما يجعله تعليقًا، وبالتالي لن يتم تنفيذ هذا السطر وسيتم فقط تغيير محتوى الفقرة.

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

على سبيل المثال:

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

كل ما هو موجود بين /* و */ يعتبر تعليقًا، وبالتالي لن يتم تنفيذ أي من الأسطر المحصورة داخله.

ملخص:

يساعد استخدام التعليقات بهذه الطريقة المطورين على اختبار أجزاء معينة من الكود دون التأثير على باقي أجزاء البرنامج.