Halaman sudah tampil rapi saat kamu uji di laptop sendiri, tapi begitu dibuka pengguna, tombol tidak merespons dan console penuh tulisan merah. Error JavaScript di browser sering muncul dari kondisi yang jarang kamu duga: data server kosong, koneksi lambat, atau elemen yang belum selesai dimuat. Cara menangani error JavaScript di browser yang baik dimulai dari memahami jenis error yang muncul, lalu memilih alat tangkap yang sesuai.
JavaScript berhenti mengeksekusi blok kode ketika error tidak tertangani. Satu baris gagal, efek berantai ke fungsi lain di bawahnya. Penanganan error karena itu bagian dari alur kode yang kamu tulis sehari-hari.
Kenali dulu tiga jenis error yang paling sering
Sebelum menulis blok try...catch, kamu perlu tahu apa yang sedang gagal. Sebagian besar masalah di halaman web masuk ke salah satu dari tiga kelompok berikut.
- TypeError terjadi saat kamu memanggil properti atau metode dari nilai yang bukan objek, misalnya
null.valueatauundefined.map(). Biasanya muncul karena selectordocument.querySelectortidak menemukan elemen. - ReferenceError muncul ketika variabel dipakai sebelum dideklarasikan atau salah ketik nama. Contoh klasik: memanggil fungsi yang belum dimuat karena skrip lain gagal lebih dulu.
- SyntaxError berarti mesin JavaScript tidak bisa membaca kode sama sekali. Koma berlebih di objek, kurung kurawal tidak seimbang, atau
consttanpa nilai awal.
Membaca nama error di console sudah mempersempit pencarian. Pesan pertama biasanya penyebab, sisanya efek lanjutan.
Gunakan try-catch hanya di sekitar kode yang bisa gagal
try...catch menangkap error sinkron. Tempelkan blok ini pada operasi yang memang berisiko, seperti parsing JSON dari respons server atau memproses data yang bentuknya tidak kamu kontrol.
function bacaRespons(teks) {
try {
const data = JSON.parse(teks);
return data.nama || 'Tanpa nama';
} catch (err) {
console.error('Respons bukan JSON valid:', err.message);
return null;
}
}
Hindari membungkus seluruh isi skrip dalam satu try raksasa. Ketika salah satu baris gagal, kamu tidak tahu baris mana, dan sisanya tetap berhenti. Bungkus bagian yang spesifik supaya fungsi lain bisa tetap berjalan.
Kalau operasi tersebut melibatkan permintaan jaringan, tangkap juga penolakan promise dengan .catch() atau async/await. Error pada fetch tidak masuk ke try...catch biasa kalau kamu lupa menunggu promise-nya.
Pasang penangkap global sebagai jaring pengaman
Error yang lolos dari try...catch tetap bisa kamu rekam lewat window.onerror dan event unhandledrejection. Ini berguna untuk logging di produksi tanpa harus menebak dari laporan pengguna.
window.addEventListener('error', (event) => {
console.warn('Error tertangkap:', event.message, 'di', event.filename, event.lineno);
});
window.addEventListener('unhandledrejection', (event) => {
console.warn('Promise ditolak tanpa penanganan:', event.reason);
});
Jaring pengaman ini tidak memperbaiki masalah, tapi memberimu jejak kejadian. Kalau memakai layanan pemantauan eksternal, kirim ringkasan pesan dan lokasi baris dari sini, bukan seluruh objek error yang bisa terlalu besar.
Cek urutan pemuatan skrip dan selector DOM
Banyak laporan “tombol tidak berfungsi” berakar dari skrip yang dijalankan sebelum elemen ada. Browser membaca dari atas ke bawah. Kalau tag <script> berada di <head> tanpa atribut defer, kode langsung jalan saat elemen target belum terbentuk.
- Pindahkan skrip ke akhir
<body>, atau tambahkan atributdeferpada tag skrip. - Bungkus akses DOM di dalam listener
DOMContentLoadedbila skrip tetap di kepala. - Periksa hasil selector sebelum dipakai:
if (!tombol) return;mencegah TypeError yang tidak perlu.
Masalah sejenis sering muncul saat PHP dan JavaScript berada di halaman yang sama, misalnya array PHP yang tidak sampai ke JavaScript. Penanganan error yang tepat di sisi klien membuat gejala seperti ini lebih mudah dilacak.
Manfaatkan console dengan cara yang lebih terarah
console.log untuk segala hal justru menyulitkan. Pakai level yang berbeda supaya informasi penting tidak tenggelam.
console.infountuk alur normal yang ingin kamu pantau.console.warnuntuk kondisi mencurigakan yang belum gagal, seperti data kosong.console.tableuntuk array objek hasil respons server.console.tracesaat kamu perlu tahu dari fungsi mana sebuah pemanggilan berasal.
Gunakan panel Sources di DevTools untuk memasang breakpoint. Kamu bisa menghentikan eksekusi di baris tertentu, memeriksa nilai variabel, lalu melangkah baris demi baris. Cara ini jauh lebih cepat daripada menebak lewat log berserakan.
Rancang penanganan error sebagai bagian dari fungsi
Fungsi yang baik memberi tahu pemanggilnya ketika gagal, bukan diam saja. Kembalikan nilai yang jelas atau lempar error dengan pesan yang bisa dibaca.
function ambilNilai(input) {
const angka = Number(input.value);
if (Number.isNaN(angka)) {
throw new Error('Input harus berupa angka');
}
return angka;
}
Pemanggil fungsi kemudian bisa menampilkan pesan ke pengguna tanpa membuat seluruh halaman berhenti. Pola ini juga memudahkan pengujian karena kamu tahu persis kondisi apa yang dianggap gagal.
Di sisi pengguna, tampilkan pesan yang menenangkan, bukan detail teknis. Simpan detail teknis di console atau log server. Pengguna cukup tahu bahwa ada yang perlu dicoba ulang.
Kalau proyekmu makin besar dan kesalahan mulai sulit dilacak, merapikan struktur kode lebih dulu akan menghemat banyak waktu. Panduan seperti kesalahan umum menulis kode PHP bisa jadi acuan karena prinsipnya mirip di JavaScript.
Ringkasan
Error JavaScript di browser paling cepat ditangani dengan mengenali jenisnya, membungkus operasi berisiko dalam try...catch, dan memasang penangkap global untuk kasus yang lolos. Periksa juga urutan pemuatan skrip dan manfaatkan DevTools ketimbang menumpuk console.log. Untuk alur data dari server, pastikan format respons bisa diprediksi agar parsing tidak gagal di tengah jalan.
Pertanyaan yang Sering Diajukan
Apakah try-catch bisa menangkap error dari setTimeout?
Tidak. Callback di dalam setTimeout berjalan di tumpukan panggilan yang berbeda, sehingga error-nya tidak tertangkap blok try di sekitarnya. Bungkus logika di dalam callback dengan try...catch sendiri atau gunakan penangkap global window.onerror.
Apa bedanya window.onerror dan unhandledrejection?
window.onerror menangkap error sinkron yang tidak tertangani, sedangkan unhandledrejection khusus untuk promise yang ditolak tanpa .catch(). Keduanya bisa dipasang bersama karena menangani jalur kegagalan yang berbeda.
Bagaimana cara menampilkan error ke pengguna tanpa membocorkan detail?
Tampilkan pesan singkat di halaman, misalnya instruksi untuk mencoba lagi. Detail seperti nama fungsi dan nomor baris cukup dikirim ke console atau log server. Ini menjaga pengalaman pengguna tetap rapi sekaligus memudahkan kamu saat menelusuri masalah.