تعليقات JavaScript
يمكن استخدام تعليقات JavaScript لشرح كود JavaScript ، ولجعلها أكثر قابلية للقراءة.
يمكن أيضًا استخدام تعليقات JavaScript لمنع التنفيذ ، عند اختبار كود بديل.
تعليقات سطر واحد
تبدأ التعليقات المكونة من سطر واحد بـ //
.
سيتم تجاهل أي نص يقع بين //
السطر ونهايته بواسطة JavaScript (لن يتم تنفيذه).
يستخدم هذا المثال تعليقًا من سطر واحد قبل كل سطر رمز:
مثال
// 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
تعليقات متعددة الأسطر
تبدأ التعليقات متعددة الأسطر بـ /*
وتنتهي بـ */
.
سيتم تجاهل أي نص بين /*
و JavaScript.*/
يستخدم هذا المثال تعليقًا متعدد الأسطر (جزء تعليق) لشرح الكود:
مثال
/*
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.";
من الأكثر شيوعًا استخدام تعليقات سطر واحد.
غالبًا ما تستخدم التعليقات الجماعية للتوثيق الرسمي.
استخدام التعليقات لمنع التنفيذ
يعد استخدام التعليقات لمنع تنفيذ التعليمات البرمجية مناسبًا لاختبار الكود.
تؤدي الإضافة //
أمام سطر التعليمات البرمجية إلى تغيير خطوط التعليمات البرمجية من سطر قابل للتنفيذ إلى تعليق.
يستخدم هذا المثال // لمنع تنفيذ أحد أسطر الكود:
مثال
//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.";
*/