6- دروس جافا سكربت – JS Comments

### الشرح المفصل للتعليقات في لغة JavaScript

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

#### أنواع التعليقات في JavaScript

هناك نوعان رئيسيان من التعليقات في JavaScript:

1. **التعليقات الأحادية السطر (Single-line Comments):**
تستخدم لتعليق سطر واحد فقط من التعليمات البرمجية. يتم إنشاء [شركة برمجة مصرية] تعليق أحادي السطر عن طريق وضع علامتي `//` قبل النص الذي ترغب في التعليق عليه.

**مثال:**

// هذا [شركة برمجة مصرية]  تعليق أحادي السطر
   let x = 5; // تعيين القيمة 5 للمتغير x
   

2. **التعليقات متعددة الأسطر (Multi-line Comments):**
تستخدم لتعليق عدة أسطر من التعليمات البرمجية. يتم إنشاء تعليق متعدد الأسطر باستخدام `/*` لبدء التعليق و `*/` لإنهائه.

**مثال:**

/*
    هذا تعليق متعدد الأسطر
    يشرح عملية حساب قيمة
    المجموع
   */
   let sum = 0;
   for (let i = 0; i <= 10; i++) {
       sum += i;
   }
   

#### استخدامات التعليقات في JavaScript

1. **شرح الشيفرات المعقدة:**
عندما تتعامل مع شيفرة معقدة أو خوارزمية غير بديهية، من المهم استخدام التعليقات لتوضيح ما تقوم به الشيفرة.

**مثال:**

// استخدام خوارزمية البحث الثنائي لتحسين سرعة البحث
   function binarySearch(arr, target) {
       let left = 0;
       let right = arr.length - 1;
       while (left <= right) {
           let mid = Math.floor((left + right) / 2);
           // تحقق مما إذا كان العنصر في المنتصف هو الهدف
           if (arr[mid] === target) return mid;
           // إذا كان الهدف أصغر، تجاهل النصف الأيمن
           if (arr[mid] < target) left = mid + 1;
           // إذا كان الهدف أكبر، تجاهل النصف الأيسر
           else right = mid - 1;
       }
       return -1; // عودة -1 إذا لم يتم العثور على الهدف
   }
   

2. **تعليق الأكواد غير المكتملة:**
في بعض الأحيان، قد تحتاج إلى ترك جزء من الشيفرة غير مكتمل مؤقتًا. التعليقات تساعد في تذكيرك بما يجب القيام به لاحقًا.

**مثال:**

// TODO: تحسين أداء هذه الوظيفة لاحقًا
   function slowFunction() {
       // تنفيذ بعض العمليات البطيئة
   }
   

3. **تعطيل الأكواد أثناء التصحيح:**
التعليقات يمكن استخدامها لتعطيل جزء من الشيفرة البرمجية أثناء عملية تصحيح الأخطاء دون حذفها.

**مثال:**

// console.log("هذا السطر معطل مؤقتًا");
   let y = 10;
   

#### نصائح لاستخدام التعليقات بفعالية

– **اجعل التعليقات موجزة وواضحة:** تجنب الإسهاب غير الضروري في التعليقات. اجعلها مباشرة وتخدم الغرض منها بوضوح.
– **تجنب التعليقات البديهية:** لا تعلق على الشيفرة الواضحة التي يمكن فهمها بسهولة من خلال قراءة الكود نفسه.
– **تحديث التعليقات:** تأكد من أن التعليقات تعكس دائمًا حالة الشيفرة الحالية خاصة بعد إجراء التعديلات.

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