التعليقات
تعرف كيف تكتب تعليمات وقيمًا بصياغة صحيحة. هذه الجلسة تضيف شيئًا يتخطّاه المحرّك: التعليقات — ملاحظات لك وللأشخاص الذين يقرأون الشيفرة.
ما هي تعليقات JavaScript وكيف تكتبها؟
التعليق نص يتجاهله محرّك JavaScript. لا يغيّر سلوك البرنامج. استخدم // لملاحظة تنتهي بنهاية ذلك السطر، أو /* … */ لملاحظة قد تمتد لسطر أو أكثر. التعليقات تشرح لماذا، تترك تذكيرات، أو تعطّل سطرًا مؤقتًا أثناء الاختبار.
أشكال التعليق بنظرة سريعة
📊 كيف يستخدم المبتدئ التعليقات
| الشكل | مثال | متى تستخدمه |
|---|---|---|
سطر واحد // |
// رسالة ترحيب |
ملاحظة قصيرة فوق السطر أو في نهايته |
عدة أسطر /* */ |
/* عدة أسطر من الملاحظات */ |
شرح أطول، أو عدة أسطر معًا |
| بعد الشيفرة | console.log(x); // فحص مؤقت |
تذكير صغير بجانب التعليمة |
| تعطيل سطر | // console.log(x); |
إيقاف تعليمة مؤقتًا دون حذفها |
| ليست للمحرّك | (أي تعليق) | الزائر لا «يشغّل» تعليقاتك — يقرأها البشر فقط |
تعليقات السطر الواحد مع //
كل شيء من // حتى نهاية ذلك السطر تعليق. الشيفرة قبل // على نفس السطر ما زالت تُنفَّذ.
console.log("Hello"); // ترحيب في Console
console.log(42); // قيمة حرفية رقمية
يمكنك أيضًا وضع // وحده في سطره، فوق التعليمة التي يصفها.
// اطبع رسالة حالة قصيرة
console.log("Ready");
تعليقات متعددة الأسطر مع / /
ابدأ بـ /* وانتهِ بـ */. كل ما بينهما يُتجاهل — حتى عبر عدة أسطر.
/*
عرض: رحّب بالزائر مرة واحدة.
أبقِ هذا قصيرًا للمبتدئين.
*/
console.log("Welcome");
تعطيل الشيفرة مؤقتًا
وضع تعليق أمام سطر عادة شائعة أثناء التصحيح: تبقى الشيفرة في الملف، لكنها لا تُنفَّذ حتى تزيل التعليق.
console.log("This runs");
// console.log("This stays quiet");
console.log("This also runs");
السطر الأوسط فقط صامت. أزل // عندما تريد ذلك السجل مرة أخرى.
تعليقات بجانب تحديث الصفحة
تعليق قصير عن لماذا يساعد «أنت في المستقبل» عندما تحدّث تعليمة الصفحة. التعليق نفسه لا يظهر على الصفحة.
<!DOCTYPE html>
<html>
<head>
<title>Comments — Page note</title>
</head>
<body>
<h1 id="msg">Waiting…</h1>
<script>
// أظهر حالة واضحة بعد تشغيل السكربت
document.getElementById("msg").textContent = "Comments help humans";
</script>
</body>
</html>
نص العنوان يأتي من القيمة الحرفية للسلسلة. سطر // لمن يقرأ المصدر فقط.
جرّب بنفسك
- أضف ملاحظة
//فوقconsole.logوأخرى في نهاية نفس السطر؛ نفّذ وتأكد أن السجلات ما زالت تظهر. - لفّ شرحًا من سطرين داخل
/* */فوق سجل؛ غيّر نص التعليق — يجب أن يبقى الإخراج كما هو. - عطّل أحد ثلاثة أسطر
console.logبـ//، نفّذ، ثم أعده. - افتح عرض HTML؛ غيّر نص التعليق فقط؛ حدّث الصفحة وتأكد أن نص العنوان لم يتغيّر.
- اكتب تعليقًا يقول لماذا (مثل «فحص مؤقت») بدل تكرار الشيفرة حرفيًا.
أخطاء شائعة
- نسيان إغلاق
*/بعد/*— قد تُبتلع الشيفرة التالية داخل التعليق - توقّع أن
//يمتد للسطر التالي (يتوقف عند نهاية السطر) - تداخل
/* … /* … */ … */بلا حذر — التعليقات متعددة الأسطر لا تتداخل بأمان - تعليقات تعيد صياغة الشيفرة فقط بدل سبب مفيد
- الخلط مع بناء الجملة (القيم والأسماء) أو توقّع درس المتغيرات — التعليق ملاحظة وليس تخزينًا
الخلاصة
- التعليقات للبشر؛ المحرّك يتجاهلها
//يغطي بقية سطر واحد/* */قد يغطي سطرًا أو أكثر- استخدمها للسبب والتذكير والتعطيل المؤقت — لا للضوضاء
- التالي: المتغيرات — أسماء تحتفظ بقيم يمكن إعادة استخدامها
🧠 اختبر معرفتك
اختبر معرفتك
تحدى نفسك مع هذا الاختبار التفاعلي واكتشف مدى فهمك للموضوع
📝 التعليمات
- اقرأ كل سؤال بعناية
- اختر أفضل إجابة لكل سؤال
- يمكنك إعادة الاختبار عدة مرات كما تريد
- سيتم عرض تقدمك في الأعلى