Dalam tutorial ini, kita akan belajar tentang komentar JavaScript atau JavaScript Comments, mengapa Anda harus menggunakannya, dan bagaimana menggunakannya dengan bantuan contoh.

Komentar JavaScript adalah petunjuk yang bisa ditambahkan oleh programmer atau developer untuk membuat kode mereka lebih mudah dibaca dan dipahami. Mereka (Comments) benar-benar diabaikan oleh mesin JavaScript, itu artinya Komentar dalam JavaScript tidak akan di eksekusi.

Ada dua cara untuk menambahkan komentar ke kode JavaScript:

  • // Untuk Komentar Satu Baris
  • /* */ Untuk Komentar Multi-baris

Komentar Satu Baris

Dalam JavaScript, setiap baris yang dimulai dengan // adalah komentar satu baris. Sebagai contoh,

nama = "Budi";

// mencetak nama di konsol (console)
console.log("Hai " + nama);

Di sini, // nama pencetakan di konsol adalah komentar.

Kamu juga bisa menggunakan komentar satu baris seperti ini:

nama = "Budi";

console.log("Hai " + nama);	// mencetak nama di konsol (console)

Komentar Multi Baris

Dalam Javascript, teks apa pun antara /* dan */ adalah komentar multi-baris. Sebagai contoh,

/*
Caranya My Id Series JavaScript
Tutorial Komentar JavaScript
https://caranya.my.id
*/

Komentar JavaScript di atas adalah contoh yang baik di mana kamu bisa menggunakan komentar multi-baris sebanyak-banyaknya.

Menggunakan Komentar untuk Debugging

Komentar juga bisa digunakan untuk menonaktifkan kode agar tidak dieksekusi. Sebagai contoh,

console.log("Sebuah Kode");
console.log("Kode Lain");
console.log("Kode Error);

Jika kamu mendapatkan kesalahan saat menjalankan program, alih-alih menghapus kode rawan kesalahan, kamu bisa menggunakan komentar untuk menonaktifkannya agar tidak dieksekusi; ini bisa menjadi alat debugging yang berguna.

console.log("Sebuah Kode");
console.log("Kode Lain");
// console.log("Kode Error);

Tips: Ingat pintasan atau shortcut untuk menggunakan komentar agar lebih efisien; itu bisa sangat membantu. Untuk sebagian besar editor kode, mengunakan Ctrl + /.

Buat Kode Lebih Mudah Dipahami

Sebagai pengembang atau developer JavaScript, kamu tidak hanya akan menulis kode tetapi mungkin juga harus memodifikasi kode yang ditulis oleh pengembang lain.

Jika kamu menulis komentar pada kode yang kamu buat, akan lebih mudah bagi kamu untuk memahami kode di masa depan. Selain itu, akan lebih mudah bagi rekan pengembang kamu untuk memahami kode tersebut.

Buatlah komentar dengan bijak, maksud saya kode dengan komentar itu akan lebih baik karena komentar digunakan untuk memberikan sedikit informasi, akan tetapi jika kamu membuat komentar secara berlebihan itu sangat tidak baik.

Jika memang banyak info yang harus kamu berikan, lebih baik buat sebuah dokumentasi saja. Misal seperti membuat file README.MD atau bahkan membuat halaman web jika memungkinkan.

Hal itu bertujuan agar lebih efisien. Dan mungkin cukup sampai disini materi kita tentang Komentar JavaScript. Sampai jumpa di materi selanjutnya.