Clean Code: Aturan Penamaan Variabel ala Programmer Profesional

Jangan Menyiksa Rekan Kerjamu

Programmer pemula sering kali memberikan nama variabel sekenanya saja. Mereka menggunakan singkatan aneh seperti usrDt, arr1, atau nama variabel abstrak seperti data dan temp. Saat aplikasi mengalami *error* tiga bulan kemudian, sang pembuat kode pun akan lupa apa isi dari variabel data2 tersebut!

Prinsip utama Clean Code (Kode yang Bersih) adalah: Kode harus bisa dibaca layaknya buku cerita bahasa Inggris.

Aturan 1: Gunakan Nama yang Bisa Diucapkan (Pronounceable)

Jika nama variabel tidak bisa diucapkan, kamu tidak bisa mendiskusikannya dengan timmu saat rapat.

• Buruk: const yyyymmdstr = moment().format('YYYY/MM/DD'); (Coba ucapkan yyyymmdstr ke temanmu. Susah, kan?)
• Baik: const currentDate = moment().format('YYYY/MM/DD');

Aturan 2: Hindari Angka Gaib (Magic Numbers)

Sering kali *developer* menulis angka secara langsung di tengah-tengah kode logika. Angka ini membingungkan pembaca.

• Buruk: if (password.length < 8) { ... } (Kenapa harus 8?)
• Baik: Buat konstanta dengan nama jelas menggunakan huruf besar (SNAKE_CASE).
  const MIN_PASSWORD_LENGTH = 8;
if (password.length < MIN_PASSWORD_LENGTH) { ... }

Aturan 3: Penamaan Boolean (Pertanyaan Ya/Tidak)

Variabel yang berisi status benar/salah (True/False) harus terdengar seperti pertanyaan yang hanya bisa dijawab "Ya" atau "Tidak". Gunakan awalan kata is, has, atau can.

• Buruk: const valid = true;, const auth = false;
• Baik: const isValid = true;, const isAuthenticated = false;, const hasAccess = true;.

Aturan 4: Nama Fungsi Harus Berupa Kata Kerja (Verb)

Fungsi adalah sebuah aksi. Jadi nama fungsinya harus menjelaskan "aksi" apa yang dilakukannya terhadap "data" apa.

• Buruk: function email() { ... } (Ini kata benda, membingungkan. Apakah fungsinya mengirim email? Membaca email?)
• Baik: function sendEmail() { ... } atau function readEmail() { ... }.

Kesimpulan

Jangan malas mengetik nama variabel yang sedikit lebih panjang. Editor VS Code sudah memiliki fitur Autocomplete, jadi kepanjangan karakter tidak akan memperlambat ketikanmu, tapi justru akan sangat mempercepat proses pencarian bug di masa depan.