Cara Menulis Komentar di JavaScript.

Komentar adalah baris kode yang sengaja diabaikan oleh mesin JavaScript saat program dijalankan. Fungsinya bukan untuk logika program, melainkan untuk manusia: menjelaskan maksud kode, mencatat alasan sebuah keputusan teknis diambil, atau menonaktifkan kode sementara saat proses debugging.

Komentar Satu Baris

Gunakan tanda // untuk komentar satu baris. Semua teks setelah // sampai akhir baris akan diabaikan interpreter.

// Menghitung total harga setelah diskon
const total = harga - (harga * diskon);

Komentar satu baris juga sering dipakai untuk menonaktifkan sementara satu baris kode saat debugging:

// console.log(dataMentah); // sengaja dimatikan dulu
console.log(dataBersih);

Komentar Banyak Baris

Untuk blok teks yang lebih panjang, gunakan /* ... */. Semua yang ada di antara dua tanda ini diabaikan, termasuk jika menulis beberapa baris sekaligus.

/*
  Fungsi ini mengambil data pengguna dari API,
  lalu menyaring hanya pengguna yang statusnya aktif.
  Ditulis ulang Agustus 2026 agar memakai async/await.
*/
async function ambilPenggunaAktif() {
  const res = await fetch("/api/pengguna");
  const data = await res.json();
  return data.filter((pengguna) => pengguna.aktif);
}

Kapan Komentar Sebaiknya Dipakai

Komentar yang baik menjelaskan mengapa, bukan apa. Kode yang ditulis rapi biasanya sudah menjelaskan dirinya sendiri soal “apa yang terjadi”, sehingga komentar seperti berikut ini kurang berguna:

// menambah 1 ke i
i++;

Komentar akan jauh lebih bermanfaat saat menjelaskan konteks yang tidak terlihat dari kode itu sendiri, misalnya:

// Pakai setTimeout 300ms karena API pihak ketiga butuh jeda
// sebelum data barunya benar-benar tersedia
setTimeout(cekStatusPembayaran, 300);

JSDoc: Komentar untuk Dokumentasi

Di proyek JavaScript modern, komentar banyak baris sering dipakai dalam format JSDoc agar editor bisa menampilkan info tipe dan parameter secara otomatis.

/**
 * Menghitung total harga setelah diskon.
 * @param {number} harga - Harga awal barang.
 * @param {number} diskon - Persentase diskon, dalam desimal (0.1 = 10%).
 * @returns {number} Harga akhir setelah dipotong diskon.
 */
function hitungHargaAkhir(harga, diskon) {
  return harga - harga * diskon;
}

Dengan JSDoc, editor seperti VS Code bisa menampilkan tooltip parameter saat fungsi dipanggil, sehingga sangat membantu ketika bekerja dalam tim.

Kesimpulan

Komentar bukan hiasan, tapi alat komunikasi. Pakai // untuk catatan singkat, /* */ untuk penjelasan panjang, dan format JSDoc kalau ingin editor ikut membantu menampilkan dokumentasi fungsi. Aturan paling penting: tulis komentar seolah kamu menjelaskan ke diri sendiri enam bulan dari sekarang, saat detail kecilnya sudah lupa.