تعليقات JavaScript

تعليقات JavaScript تستخدم لشرح كود JavaScript وزيادة قابليته للقراءة.

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

تعليقات متعددة

تعليقات متعددة تستخدم ل // البداية.

أي شيء موجود // كل النص بين التعليق والمحطة النهاية للسطر سيتم تجاهله من قبل JavaScript (لن يتم تنفيذه).

في هذا المثال، يستخدم التعليق على كل سطر قبل الكود:

مثال

// تغيير العنوان:
 document.getElementById("myH").innerHTML = "صفحتي الأولى.";
// تغيير الفقرة:
 document.getElementById("myP").innerHTML = "مقطعي الأول.";

جرب بنفسك

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

مثال

var x = 5;      // إعلان x، وتعيين 5 له
var y = x + 2;  // إعلان y، وتعيين x + 2 له

جرب بنفسك

تعليقات متعددة

تعليقات متعددة تستخدم ل /* في البداية، مع */ في النهاية.

أي شيء موجود /* و */ النص بينها سيتم تجاهله من قبل JavaScript.

هذا المثال يستخدم تعليقات متعددة السطور (كتل التعليق) لتوضيح الأكواد:

مثال

/*
 النص التالي سيغير
 في الصفحة
 العنوان مع id = "myH":
 ومن ثم العنصر مع id = "myP":
*/
document.getElementById("myH").innerHTML = "صفحتي الأولى.";
document.getElementById("myP").innerHTML = "مقطعي الأول."; 

جرب بنفسك

تعليق:استخدام التعليقات السطرية الشائعة.

نصيحة:يستخدم كتل التعليق غالبًا في البيانات الرسمية.

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

استخدام التعليقات لمنع تنفيذ الأكواد مثالي للتحقق من الأكواد.

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

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

مثال

//document.getElementById("myH").innerHTML = "صفحتي الأولى.";
document.getElementById("myP").innerHTML = "مقطعي الأول."; 

جرب بنفسك

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

مثال

/*
document.getElementById("myH").innerHTML = "صفحتي الأولى.";
document.getElementById("myP").innerHTML = "مقطعي الأول.";
*/

جرب بنفسك

قراءة خارجية

دليل متقدم لـ JavaScript: قواعد اللغة ECMAScript