تعليقات في JavaScript

• أبريل 16, 2024

التعليقات هي تلك التعليقات التي تضعها في JavaScript أو HTML لتوضيح ما يجري. هناك عدة طرق لوضع التعليقات في شفرة JavaScript الخاصة بك. يعد بناء جملة التعليقات - كيفية إخبار البرنامج النصي أو المستند أن هناك شيء ما وليس تعليقًا أو بيانات - أمرًا بسيطًا للغاية. من الصعب كتابة التعليقات الجيدة ، ومن النظر إلى الكود (مضمن) ، يبدو أن الجزء الأصعب هو فعل ذلك!

يحتوي JavaScript على نوعين من التعليقات وتعليق من سطر واحد وتعليق متعدد الأسطر.

يبدأ تعليق سطر واحد في JavaScript بشرطة مائلة للأمام (//) وينتهي في نهاية السطر (تقنيًا ، قبل حرف حرف نهاية السطر مباشرةً). تعليقات سطر واحد مفيدة بشكل خاص للملاحظات القصيرة.

// هذا تعليق سطر واحد
البيانات = "بياناتي" // هذا تعليق سطر واحد أيضًا

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

/ * هذا سطر واحد من تعليق متعدد الأسطر
هذا لا يزال جزءًا من تعليقي
هذا هو الجزء الأخير من تعليقي * /

/ * هذا تعليق نمط متعدد الأسطر على سطر واحد * /

تشاهد غالبًا علامات نجمية إضافية تضاف إلى تعليقات متعددة الأسطر لإنشاء مربعات معلومات زخرفية ، مثل:

/*********************
* وظائفي *
*********************/

تعد الدالات متعددة الخطوط مفيدة بشكل خاص في بداية البرنامج أو القسم من البرنامج لوصف ما يهدف إليه البرنامج وكيف يفعله.

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

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

تعليمات الفيديو: 07 javascript جافا سكريبت comments التعليقات (أبريل 2024).