Dalam tutorial ini, anda akan belajar mengenai komen JavaScript, mengapa anda harus menggunakannya, dan bagaimana menggunakannya dengan bantuan contoh.
Komen JavaScript adalah petunjuk yang dapat ditambahkan oleh pengaturcara agar kod mereka lebih mudah dibaca dan difahami. Mereka tidak diendahkan sepenuhnya oleh mesin JavaScript.
Terdapat dua cara untuk menambahkan komen pada kod:
//- Komen Garis Tunggal/* */-Komen pelbagai baris
Komen Garis Tunggal
Dalam JavaScript, mana-mana baris yang dimulakan //adalah komen baris tunggal. Sebagai contoh,
name = "Jack"; // printing name on the console console.log("Hello " + name);
Inilah // printing name on the consolekomen.
Anda juga boleh menggunakan komen satu baris seperti ini:
name = "Jack"; console.log("Hello " + name); // printing name on the console
Komen berbilang baris
Dalam Javascript, sebarang teks antara /*dan */merupakan komen berbilang baris. Sebagai contoh,
/* The following program contains the source code for a game called Baghchal. Baghchal is a popular board game in Nepal where two players choose either sheep or tiger. It is played on a 5x5 grid. For the player controlling the tiger to win, they must capture all the sheep. There are altogether 4 tigers on the board. For the sheep to win, all tigers must be surrounded and cornered so that they cannot move. The player controlling the sheep has 20 sheep at his disposal. */
Oleh kerana kod sumber yang lain akan digunakan untuk melaksanakan peraturan permainan, komen di atas adalah contoh yang baik di mana anda mungkin menggunakan komen berbilang baris.
Menggunakan Komen untuk Menyahpepijat
Komen juga dapat digunakan untuk menonaktifkan kod untuk mencegahnya dijalankan. Sebagai contoh,
console.log("some code"); console.log("Error code); console.log("other code");
Sekiranya anda mendapat ralat semasa menjalankan program, alih-alih membuang kod rawan kesalahan, anda boleh menggunakan komen untuk melumpuhkannya daripada dilaksanakan; ini boleh menjadi alat penyahpepijatan yang berharga.
console.log("some code"); // console.log("Error code); console.log("other code");
Petua Pro: Ingat jalan pintas untuk menggunakan komen; ia boleh sangat membantu. Bagi kebanyakan penyunting kod, ini Ctrl + /untuk Windows dan Cmd + /Mac.
Jadikan Kod Lebih Mudah difahami
Sebagai pembangun JavaScript, anda bukan sahaja menulis kod tetapi juga perlu mengubah kod yang ditulis oleh pembangun lain.
Sekiranya anda menulis komen pada kod anda, akan lebih mudah bagi anda untuk memahami kod tersebut pada masa akan datang. Juga, lebih mudah bagi rakan pemaju anda untuk memahami kodnya.
Sebagai peraturan umum, gunakan komen untuk menjelaskan mengapa anda melakukan sesuatu daripada cara anda melakukan sesuatu, dan anda baik.
Catatan: Komen tidak boleh menjadi pengganti cara untuk menjelaskan kod yang kurang ditulis dalam bahasa Inggeris. Anda harus selalu menulis kod yang tersusun dan jelas. Dan kemudian gunakan komen.
