Cara membuat global error handler Express adalah menaruh satu middleware error khusus di baris paling akhir setelah semua route, dengan signature err, req, res, next. Express otomatis mengarahkan error yang dilempar lewat throw atau next(err) ke sana, sehingga API mengembalikan JSON rapi bukan crash atau HTML bawaan.
Yang Dibutuhkan Sebelum Membuat Error Handler
Handler ini hanya bekerja kalau posisinya benar dan format responsnya konsisten.
- Letakkan error handler di paling akhir setelah route dan middleware lain.
- Siapkan format JSON konsisten, misalnya status dan message.
- Bedakan operational error 4xx seperti input salah dengan programmer error 500.
- Teruskan error async dengan next(err) atau try catch.
Langkah Membuat Global Error Handler Express
Contoh minimal ini memakai CommonJS dan tanpa package tambahan.
1. Buat route contoh yang melempar error:
const express = require('express');
const app = express();
app.use(express.json());
app.get('/gagal', (req, res, next) => {
const err = new Error('Data tidak ditemukan');
err.statusCode = 404;
next(err);
});
2. Tambah middleware 404 untuk route tidak ditemukan:
app.use((req, res, next) => {
const err = new Error(`Route ${req.originalUrl} tidak ditemukan`);
err.statusCode = 404;
next(err);
});
3. Buat middleware error dengan signature err req res next:
app.use((err, req, res, next) => {
const statusCode = err.statusCode || 500;
res.status(statusCode).json({
status: statusCode >= 500 ? 'error' : 'fail',
message: err.message || 'Terjadi kesalahan server'
});
});
app.listen(3000);
4. Uji dengan error sync, async, dan status kustom:
app.get('/async-gagal', async (req, res, next) => {
try {
throw new Error('Query database gagal');
} catch (err) {
next(err);
}
});
Komponen Wajib di Dalam Handler
Handler yang bagus mencatat detail di server, tapi hanya mengirim pesan aman ke klien.
| Komponen | Fungsi | Contoh |
|---|---|---|
| statusCode | Menentukan kode HTTP | 400, 404, 500 |
| message | Pesan aman untuk klien | Data tidak valid |
| stack | Pelacakan error untuk debug | err.stack di log |
- Sembunyikan stack trace saat NODE_ENV production.
- Catat log server dengan console.error(err) tanpa membocorkan detail ke klien.
if (process.env.NODE_ENV !== 'production') {
console.error(err.stack);
}
FAQ
Di mana meletakkan global error handler di Express?
Di akhir setelah semua route agar semua error tertangkap.
Kenapa error async tidak masuk ke handler?
Karena promise rejection harus diteruskan manual lewat next(err).
Apakah perlu menampilkan stack ke klien?
Tidak, tampilkan hanya saat development dan sembunyikan di production.