کامنت ها

کامنت‌ها (Comments) یا همان یادداشت‌های درون کد

کامنت‌ها در واقع یادداشت‌هایی هستند که برای خودت یا بقیه برنامه‌نویس‌ها توی کد می‌گذاری تا یادتون بمونه فلان تیکه کد داره چیکار میکنه. جاوااسکریپت موقع اجرای برنامه، کامنت‌ها رو کاملاً نادیده می‌گیره (مثل یک فضای خالی) و اصلاً اجراشون نمی‌کنه.

نحوه نوشتن کامنت در جاوااسکریپت دقیقاً مثل زبان‌های ++C و خیلی از زبان‌های دیگه است و به دو صورت انجام میشه:

۱. کامنت‌های تک‌خطی

اگر یادداشت تو فقط یک خطه، کافیه اولش دو تا اسلش (//) بگذاری:

// این یک کامنت تک‌خطی است و این خط اصلاً اجرا نمیشه
const age = 25;

۲. کامنت‌های چندخطی (بلوکی)

اگر توضیحاتت طولانیه و می‌خوای چند خط براش بنویسی، باید اولش از */ و آخرش از /* استفاده کنی:

/* این یک کامنت چندخطی است.
   می‌تونی هر چقدر دلت خواست اینجا بنویسی
   بدون اینکه نگران ارور خوردن کد باشی. */

یک اشتباه رایج: کامنت‌های تو دورتو!

تو نمی‌تونی یک کامنت چندخطی رو داخل یک کامنت چندخطی دیگه قرار بدی (اصطلاحاً لایه‌بندی یا Nest کنی). چرا؟ چون جاوااسکریپت به اولین علامت پایانی که برسه، کل کامنت رو می‌بنده و بقیه کدت خراب میشه و ارور SyntaxError می‌گیری.

به این مثال اشتباه نگاه کن:

/* من دارم کامنت می‌نویسم /* و این وسط یک کامنت دیگه باز می‌کنم */ این تیکه بیرون می‌مونه و ارور میده! *

چون سیستم به اولین */ که می‌رسه فکر میکنه کامنت تموم شده، کلمات بعد از اون رو جزو کدهای اصلی فرض میکنه و گیج میشه.

راه‌حل چیه؟ اگر مجبور شدی چنین کاری کنی، باید علامت اسلش آخر رو با یک بک‌اسلش (\) خنثی یا اسکیپ (Escape) کنی تا جاوااسکریپت فریب نخوره:

/* حالا می‌تونی /* کامنت‌ها رو تو در تو کنی *\/ چون اسلش رو خنثی کردی! */

نکته جذاب: کامنت‌های هش‌بنگ (Hashbang) چی هستند؟

شاید گاهی اوقات اولِ اولِ بعضی از فایل‌های جاوااسکریپت، یک چیزی شبیه به این ببینی:

#!/usr/bin/env node

به این مدل می‌گن کامنت Hashbang یا Shebang. این یک کامنت خاصه و زمانی استفاده میشه که می‌خوایم این فایل جاوااسکریپت مستقیماً توی محیط‌هایی مثل ترمینال لینوکس یا مک اجرا بشه. این خط به سیستم آدرس میده و میگه: «هی سیستم! برای اجرای این فایل، برو از موتور جاوااسکریپتی که توی این مسیر هست (مثلاً Node.js) استفاده کن».