Cara Mengatasi Express Req Params Undefined karena Route Salah Tulis

req.params undefined hampir selalu karena route salah tulis. Pola paling sering: kamu menulis /users/id tanpa titik dua, sehingga Express menganggap id sebagai teks statis. Perbaiki menjadi /users/:id, samakan nama param di controller, lalu akses lewat /users/123.

Penyebab Express Req Params Undefined Paling Sering

Express hanya mengisi req.params kalau path route memakai pola :namaParam. Salah satu karakter saja cukup membuat hasilnya objek kosong.

  • Route tanpa titik dua, contoh /user/id dibaca sebagai URL literal, bukan parameter.
  • Nama param beda, route memakai :id tetapi controller membaca req.params.userId.
  • Tertukar sumber data, ID dikirim sebagai /users?id=123 padahal kode membaca req.params.id.
  • Urutan route bertabrakan, route statis seperti /users/new tertutup oleh /users/:id atau sebaliknya.

Tabel Diagnosis Cepat Req.Params Undefined

Cocokkan gejala yang kamu alami dengan baris berikut sebelum mengubah controller.

Masalah Penyebab Solusi
req.params kosong {} Route tanpa : Ubah ke /users/:id
req.params.id undefined Nama param beda Samakan :id dengan req.params.id
ID ada di URL tapi tidak terbaca Pakai query string Panggil /users/123, bukan /users?id=123

Pola salah: app.get('/users/id'). Pola benar: app.get('/users/:id').

Perbaiki Route dan Cara Baca Params dalam 5 Langkah

  1. Cek path route. Pastikan ada titik dua, contoh /users/:id.
  2. Samakan nama param. Kalau route :id, baca req.params.id, bukan req.params.userId.
  3. Panggil URL dengan cara benar. Gunakan /users/123 untuk req.params dan /users?id=123 hanya untuk req.query.
  4. Cek urutan route. Daftarkan /users/new sebelum /users/:id supaya new tidak terbaca sebagai ID.
  5. Log objeknya. Tambahkan console.log(req.params) untuk memastikan Express mengirim apa.
app.get('/users/:id', (req, res) => {
  console.log(req.params);
  const { id } = req.params;

  if (!id) {
    return res.status(400).json({ message: 'ID wajib diisi' });
  }

  res.json({ id });
});
  • Params terisi { id: '123' } saat URL dibuka dengan /users/123.
  • Kode tidak lagi membaca ID query atau body untuk route berbasis params.
  • Validasi menolak ID kosong dengan respons 400 yang konsisten.

FAQ

Kenapa req.params undefined padahal URL ada ID-nya?

URL memakai query string seperti ?id=123, sedangkan kode membaca req.params.

Apa beda req.params dengan req.query di Express?

req.params berasal dari segmen path seperti /users/123, req.query berasal dari query string setelah tanda tanya.

Kenapa nama param harus sama persis?

Express memakai nama setelah titik dua sebagai kunci objek, jadi :id dan :userId menghasilkan properti berbeda.