توضیحات (کامنت)
بلدید دستور بنویسید و مقدار را با نحو درست بگذارید. حالا چیزی اضافه می‌کنیم که موتور ردش می‌کند: کامنت — یادداشت برای خودتان و بقیهٔ آدم‌هایی که کد را می‌خوانند.
کامنت در 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 را باز کنید؛ فقط متن کامنت را عوض کنید؛ رفرش کنید و ببینید متن عنوان عوض نشده.
- یک کامنت بنویسید که چرا را بگوید (مثلاً «چک موقت») نه اینکه کد را لفظ‌به‌لفظ تکرار کند.
اشتباه‌های رایج
- فراموش کردن
*/بعد از/*— ممکن است کد بعدی داخل کامنت بیفتد - انتظار اینکه
//به خط بعد هم ادامه دهد (تا آخر همان خط تمام می‌شود) - تو در تو گذاشتن بی‌دقت
/* … /* … */ … */— کامنت چندخطی به‌خوبی تو در تو نمی‌شود - کامنتی که فقط کد را تکرار می‌کند (
// لاگ helloکنارconsole.log("hello")) به‌جای یک «چرا»ی مفید - قاطی کردن این جلسه با نحو (لیترال و نام) یا انتظار جلسهٔ متغیرها — کامنت یادداشت است، نه محل نگه‌داشتن مقدار
جمع‌بندی
- کامنت برای انسان است؛ موتور نادیده‌اش می‌گیرد
//بقیهٔ همان خط را پوشش می‌دهد/* */می‌تواند یک یا چند خط باشد- برای چرا، یادآوری و خاموش کردن موقت استفاده کنید — نه برای شلوغی بی‌فایده
- بعدی: متغیرها — اسم‌هایی که مقدار نگه می‌دارند و دوباره استفاده می‌کنید
🧠 دانش خود را بیازمایید
دانش خود را بیازمایید
خود را با این آزمون تعاملی به چالش بکشید و ببینید موضوع را چقدر خوب درک کرده‌اید
📝 دستورالعمل‌ها
- هر سوال را با دقت بخوانید
- بهترین پاسخ را برای هر سوال انتخاب کنید
- می‌توانید آزمون را هر چند بار که می‌خواهید تکرار کنید
- پیشرفت شما در بالا نمایش داده می‌شود