توضيحات در جاوااسكريپت براي تشريح كدهاست وباعث خوانائي بيشتر برنامه ميشود .همچنين ميتوان براي آزمايش بهتر برنامه از اجراي بخشي ازكدها جلوگيري كرده وكدجايگزين را اجرانمود.
شروع توضيح تك خطي با// شروع ميشود .هر متني بعداز آن تاانتهاي خط توسط مرورگر ناديده گرفته ميشود.
مثال ـ توضيح تك خطي
// 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
توضيح چند خطي با/* شروع وبه*/ ختم ميشود .اين ها هم مشابه قبلي توسط مرورگر ناديده گرفته ميشود.
مثال ـ نمونه توضيح چند خطي
/*
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.";
*/