Penanganan Galat (Error Handling), Custom Error, dan Error cause

Mengapa Program Tidak Boleh "Menelan Galat Diam-Diam"?

Kesalahan jaringan, masukan JSON yang rusak, atau penyimpanan peramban yang penuh adalah kenyataan sehari-hari di lingkungan produksi. Dua kesalahan paling berbahaya dalam menangani galat adalah:

1. Tidak menangani galat sama sekali pada operasi berisiko (seperti JSON.parse()), sehingga satu data yang rusak menghentikan seluruh eksekusi skrip di halaman pengguna.
2. **Menelan galat secara diam-diam (silent catch)** dengan menulis try { ... } catch (e) {} kosong tanpa pencatatan atau pemulihan, sehingga ketika fitur gagal bekerja, tidak ada seorang pun yang tahu apa penyebabnya!

1. Mekanisme try...catch...finally dan throw

function bacaKonfigurasiJson(teksMentah) {
  try {
    const data = JSON.parse(teksMentah);

    if (!data || typeof data.port !== "number") {
      // Melempar galat secara sengaja jika struktur data tidak memenuhi syarat
      throw new TypeError("Properti 'port' wajib berupa angka.");
    }

    return data;
  } catch (galat) {
    // Blok catch menangkap galat dari JSON.parse() maupun dari throw di atas
    console.error("Gagal memuat konfigurasi, menggunakan nilai bawaan:", galat.message);
    return { port: 8080, mode: "aman" };
  } finally {
    // Blok finally SELALU dijalankan di akhir (baik sukses maupun gagal,
    // bahkan jika di dalam try/catch terdapat perintah return!)
    console.log("Pemeriksaan konfigurasi selesai.");
  }
}

2. Mengenal Jenis-Jenis Error Bawaan JavaScript

Setiap objek galat standar memiliki properti name dan message:

3. Membuat Custom Error Class dan Merangkai Penyebab dengan { cause }

Dalam aplikasi yang terstruktur, bagian tampilan (UI layer) perlu membedakan apakah kegagalan terjadi karena kesalahan input pengguna (GalatValidasi), kesalahan jaringan/server (GalatJaringan), atau bug pemrograman (TypeError).

Kita dapat membuat kelas galat khusus dengan mewarisi Error, serta meneruskan galat asli tingkat bawah menggunakan opsi { cause: galatAsli } (status Baseline Widely Available sejak ES2022):

class GalatLayananData extends Error {
  constructor(pesan, { kodeStatus = 500, cause } = {}) {
    // Meneruskan pesan dan opsi { cause } ke konstruktor Error bawaan
    super(pesan, { cause });
    this.name = "GalatLayananData";
    this.kodeStatus = kodeStatus;
  }
}

class GalatValidasiInput extends Error {
  constructor(kolom, pesan) {
    super(`Kolom '${kolom}': ${pesan}`);
    this.name = "GalatValidasiInput";
    this.kolom = kolom;
  }
}

// Contoh menangkap galat tingkat rendah, membungkusnya dengan konteks bisnis yang jelas,
// namun tetap mempertahankan jejak galat aslinya lewat 'cause':
function ambilProfilDariCache(teksJson) {
  try {
    return JSON.parse(teksJson);
  } catch (galatAsli) {
    throw new GalatLayananData(
      "Data profil di penyimpanan lokal rusak dan tidak dapat diurai.",
      { kodeStatus: 422, cause: galatAsli }
    );
  }
}

// Menangani galat secara selektif dengan instanceof (dan melempar ulang galat yang tidak dikenal!)
try {
  ambilProfilDariCache("{ json_rusak ");
} catch (err) {
  if (err instanceof GalatLayananData) {
    console.warn(`[Status ${err.kodeStatus}] ${err.message}`);
    console.warn("Penyebab teknis asli:", err.cause.message);
  } else {
    // Jangan menelan bug tak terduga! Lempar ulang jika bukan galat yang kita antisipasi.
    throw err;
  }
}

Kesalahan Umum dan Cara Menghindarinya

1. Menangkap semua galat di catch dan menganggap semuanya adalah satu masalah yang sama:
   • Buruk: Menulis blok try sepanjang 50 baris lalu di dalam catch langsung menampilkan "Koneksi internet Anda terputus", padahal yang terjadi di dalam try adalah TypeError akibat salah ketik nama variabel!
   • Lebih Baik: Jaga agar blok try sekecil dan sespesifik mungkin hanya di sekitar operasi yang memang berisiko gagal, dan periksa tipe galat menggunakan instanceof di dalam catch.
2. Menggunakan return di dalam blok finally:
   • Bahaya: Jika Anda menulis pernyataan return nilaiLain di dalam blok finally, pernyataan tersebut akan menimpa nilai return dari blok try dan bahkan membatalkan throw galat dari blok catch! Gunakan finally murni hanya untuk pembersihan sumber daya (seperti mematikan indikator loading atau menutup koneksi).

Latihan Praktik: Validator Data Transaksi dengan Custom Error

Buatlah berkas validasi-transaksi.js dan jalankan dengan Node.js:

1. Buat class GalatTransaksi extends Error yang menerima (pesan, { kode, cause } = {}).
2. Buat fungsi prosesPembayaran(jsonInput) yang mengurai jsonInput dengan JSON.parse() (jika gagal, lempar GalatTransaksi dengan kode: "JSON_RUSAK" dan cause berisi galat SyntaxError asli).
3. Jika nominal <= 0, lempar GalatTransaksi dengan kode: "NOMINAL_TIDAK_SAH".
4. Tangkap galat di pemanggil utama dan cetak err.kode, err.message, serta err.cause?.message.