Tangani Route Nyasar dengan Cara Membuat 404 Handler Express Node Js

Taruk 404 handler sebagai app.use() tanpa path di baris paling bawah, setelah semua route dan middleware API didaftarkan. Express membaca middleware berurutan, jadi request yang tidak cocok dengan route mana pun akan jatuh ke handler ini. Kirim res.status(404).json() berisi pesan dan req.originalUrl agar konsisten untuk API.

Kebutuhan Membuat 404 Handler di Express

Route nyasar sering terjadi karena salah ketik path, salah method, atau client memanggil versi API lama. Tanpa handler khusus, Express mengembalikan HTML bawaan yang membingungkan aplikasi frontend.

  • Posisikan 404 handler setelah semua app.get(), app.post(), dan app.use('/api', ...).
  • Bedakan 404 dengan 500. 404 berarti route tidak ada, 500 berarti kode gagal saat berjalan.
  • Bedakan juga dengan validasi input. Validasi memakai 400 karena route benar tapi data salah.
  • Pakai format JSON konsisten, misalnya { message, path, method }.

Langkah Membuat 404 Handler Express Node Js

1. Daftarkan semua route API lebih dulu, termasuk router tambahan.
2. Tambahkan app.use() tanpa path agar menangkap semua method GET, POST, PUT, DELETE.
3. Kirim status 404 dengan pesan dan path yang diminta dari req.originalUrl.
4. Uji dengan route salah, method salah, dan prefix /api yang tidak terdaftar.
5. Pastikan handler halaman HTML hanya dipakai bila aplikasi memang me-render view.

// CommonJS
const express = require('express');
const app = express();

app.get('/api/users', (req, res) => {
  res.json([]);
});

// 404 handler, paling bawah
app.use((req, res) => {
  res.status(404).json({
    message: 'Route tidak ditemukan',
    method: req.method,
    path: req.originalUrl
  });
});

app.listen(3000);
// ES Module, package.json: "type": "module"
import express from 'express';
const app = express();

app.get('/api/users', (req, res) => {
  res.json([]);
});

app.use((req, res) => {
  res.status(404).json({
    message: 'Route tidak ditemukan',
    method: req.method,
    path: req.originalUrl
  });
});

app.listen(3000);

Tabel Komponen 404 Handler

Komponen Fungsi Contoh
Middleware Menangkap request lolos route app.use()
req.originalUrl Menyimpan path asli diminta /api/user-salah
res.status 404 Menandai resource tidak ada res.status(404).json()

Jangan tertukar membaca request:

  • req.params untuk segmen URL seperti /users/:id.
  • req.query untuk ?page=1&limit=10.
  • req.body untuk data JSON atau form yang dikirim client.

Teruskan ke error middleware dengan next(err) hanya untuk error serius seperti gagal koneksi database. 404 biasa cukup dijawab langsung.

FAQ

Di mana posisi 404 handler agar tidak menimpa route aktif?

Letakkan di bawah semua route. Kalau ditaruk di atas, semua request berhenti di 404.

Apakah 404 handler perlu next(err) ke error middleware?

Tidak perlu untuk 404 biasa. Pakai next(err) hanya bila ada objek error yang harus diproses middleware error.

Bagaimana 404 handler untuk JSON API dan halaman HTML?

API menjawab JSON 404, sedangkan aplikasi view menjawab res.status(404).render('404') atau sendFile.