Karier pemula Tingkat: Pemula 2 menit baca 2 contoh kode
Buntu saat ngoding? Cara membaca galat dan bertanya dengan baik
Langkah memeriksa sendiri sebelum bertanya, cara membaca pesan galat, dan templat pertanyaan yang memudahkan orang membantumu.
Bayu Nugraha
Terbit
Daftar isi
Yang akan dipelajari
- Membaca pesan galat bagian demi bagian
- Mempersempit letak masalah
- Menyusun pertanyaan yang mudah dijawab
- Menutup pertanyaan dengan baik
Prasyarat
- Pernah menulis kode dan menemui galat (semua orang pernah)
Buntu adalah bagian normal dari ngoding, bagi pemula maupun yang sudah bertahun-tahun. Bedanya ada pada apa yang dilakukan setelahnya. Berikut urutan langkah yang dipakai tim kami sendiri.
Baca pesan galatnya, sungguh-sungguh
Pesan galat terlihat menakutkan, tetapi isinya hampir selalu tiga hal: jenis galat, penjelasan, dan lokasi. Contoh dari konsol peramban (susunan kalimatnya bisa sedikit berbeda antarperamban):
Uncaught TypeError: Cannot read properties of null (reading 'addEventListener')
at skrip.js:4
-
TypeErroradalah jenisnya: kita memperlakukan sebuah nilai dengan cara yang tidak sesuai tipenya. -
Penjelasannya: ada yang bernilai
null, lalu kita mencoba memanggiladdEventListenerpadanya. -
skrip.js:4adalah lokasinya: berkasskrip.js, baris ke-4.
Dari sini dugaan pertama sudah jelas: elemen yang dicari di baris 4 tidak ditemukan. Mungkin id-nya salah ketik, atau skrip berjalan sebelum HTML selesai dimuat.
Persempit masalahnya
- Kembalikan kode ke keadaan terakhir yang masih berjalan, lalu tambahkan perubahan sedikit demi sedikit.
-
Cetak nilai yang kamu curigai dengan
console.logtepat sebelum baris yang bermasalah. - Buat contoh sekecil mungkin yang masih memunculkan galat yang sama. Sering kali masalahnya ketemu di tahap ini.
Templat pertanyaan
Kalau masih buntu setelah 20 sampai 30 menit, bertanyalah. Pertanyaan yang baik membuat orang bisa membantu tanpa harus menebak.
Yang ingin saya capai:
Tombol "Tambah" menaikkan angka di halaman.
Yang terjadi:
Angka tidak berubah. Di konsol muncul galat (saya tempel di bawah).
Yang sudah saya coba:
1. Memeriksa ejaan id di HTML dan JavaScript.
2. Memindahkan tag script ke akhir body.
Kode terkait (sependek mungkin) dan pesan galat lengkap:
...
Tutup dengan baik
Setelah masalah selesai, tuliskan apa penyebabnya dan bagaimana kamu memperbaikinya, lalu ucapkan terima kasih. Catatan penutup itu membantu orang berikutnya yang menemui masalah serupa, dan sering kali orang itu adalah dirimu sendiri tiga bulan kemudian.
Ringkasan
- Pesan galat berisi jenis, penjelasan, dan lokasi; baca ketiganya.
- Persempit masalah sampai contoh terkecil yang masih gagal.
- Pertanyaan yang baik memuat tujuan, kejadian, upaya, dan kode terkait.
- Tuliskan penyelesaiannya setelah masalah beres.
Latihan
Kerjakan tanpa melihat contoh dulu. Buntu itu wajar; intip seperlunya.
- Buat galat dengan sengaja (misalnya salah mengetik nama variabel) dan uraikan pesannya menjadi jenis, penjelasan, dan lokasi.
- Isi templat pertanyaan untuk masalah terakhir yang kamu temui, walaupun sudah selesai.
- Simpan templat itu di berkas catatan supaya mudah dipakai lagi.
Ditulis oleh Bayu Nugraha
Penulis Git & alur kerja · 4 tutorial
Paling sering ditanya rekan soal riwayat yang kusut dan konflik penggabungan. Menulis tentang Git dengan satu tujuan: membuat pembaca tidak takut lagi pada terminal.