سنتناقش فى هذا الفصل التعليقات فى لغة جافا سكريبت JavaScript بالتفصيل، وكيفية إنشاء تعليقات فى سطر واحد وتعليقات متعددة الأسطر، مع بعض الأمثلة التوضيحة.

التعليقات فى JavaScript

عند كتابة التعليمات البرمجية ، قد يكون لديك بعض الملاحظات حول كود معين، فهذه فرصة مثالية لتضمين بعض التعليقات في الكود والتي ستشرح ما يجري. لن يساعدك هذا فقط على تذكرها لاحقًا ، ولكن إذا عرض شخص آخر الكود الخاص بك ، فسيكون قادرًا أيضًا على فهم الكود!

ميزة أخرى رائعة في التعليقات هي القدرة على التعليقات لإزالة أجزاء من التعليمات البرمجية من التنفيذ عندما تقوم بتصحيح البرامج النصية الخاصة بك.

أنواع التعليقات

1. تعليقات سطر واحد – Single Line Comments

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

مثال على إستخدام التعليق ذات سطر واحد:

// This is a single-line comment
console.log("Single line Comment In JS!"); // Here i Put Text in Console For Debugging

2. تعليقات متعددة الأسطر – Multi-line Comments

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

سيتم تجاهل أي نص بين /* و */ بواسطة JavaScript.

مثال على إستخدام التعليق متعدد الأسطر لشرح الكود:

/*
 * For Debugging we use console.log()
 * Here i use it for put some text in console!
 * Etc...........
*/
console.log("Single line Comment In JS!");

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

يعد استخدام التعليقات لمنع تنفيذ التعليمات البرمجية مناسبًا لاختبار الكود. كما يلى:

// console.log("Single line Comment In JS!");

/*
console.log("Single line Comment In JS!");
console.log("Single line Comment In JS!");
console.log("Single line Comment In JS!");
console.log("Single line Comment In JS!");
console.log("Single line Comment In JS!");
console.log("Single line Comment In JS!");
console.log("Single line Comment In JS!");
*/