تعليقات JavaScript

إذا كان التعليق سطرًا واحدًا فقط، فإن معالج جافا سكريبت يتجاهله تمامًا

عادةً ما يتم إضافة التعليقات لتقديم معلومات إضافية تتعلق بكود المصدر، مثل الشروحات، معلومات البرنامج، وشرح المعلمات

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

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

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

//　اطبع "Hello World" في المستند
document.write("Hello　World");

عند كتابة التعليقات، يُفضل تقديمها في نفس مستوى indentation للكود الذي يليها

//　تهيئة الدالة
function　showYear()　{
　　　//　مثال على date
　　　let　obj　=　new　Date();
　　　//　تخزين السنة الحالية في المتغير "myYear"
　　　let　myYear　=　obj.getFullYear();
　　　//　استخدام الأمر التالي لتدريس السنة الحالية إلى عنصر HTML ID="para"
　　　document.getElementById("para").innerHTML　=　myYear;
}

عندما يظهر تعليق سطر واحد في نهاية سطر الكود، يُسمىتعليق داخلي。

let　x　=　20;//　تخصيص عدد للـ x
let　y　=　x　+　5;　//　x　+　5　تخصيصها لـ y
document.write(y);　//　تدريس قيمة المتغير y إلى المستند

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

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

تعليقات متعددة الأطراف تبدأ بشرطة ونجم (/*) وتنتهي بنجم وشرطة (*/).

/*　تهيئة دالة greetUser
تخصيص اسم المستخدم للاسم المخصص وتدريسها
مرحباً بك.　*/
function　greetUser()　{
　　let　name　=　prompt("你的名字叫什么?");
　　document.getElementById("output").innerHTML　=　"Hello　"　+　name;
}

قد ترى أيضًا إصدارات محدثة قليلاً من لغة التعليق المدمج، والتي تبدأ بـ /** على اليسار وأيضًا نجمة.

/**
　　*تهيئة دالة greetUser.
　　*تخصيص اسم المستخدم للمعلمة.
　　*وإطبع التحية.
　　*/
function　greetUser()　{
　　let　name　=　prompt("你的名字是?");
　　document.getElementById("output").innerHTML　=　"Hello　"　+　name;
}

يُستخدم التعليق المدمج عادةً في الوثائق الرسمية.

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

يمكن للتعليقات أيضًا استخدامها لمنع تنفيذ الكود بسرعة وسهولة لأغراض الاختبار والتصحيح.

//　addTwoNumbers(5,　5);
multiplyTwoNumbers(6,　3);

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

/*
document.write("Hello　World<br>");
document.write("Hello　World<br>");
document.write("Hello　World<br>");
document.write("Hello　World");
*/

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