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/iddibaca sebagai URL literal, bukan parameter. - Nama param beda, route memakai
:idtetapi controller membacareq.params.userId. - Tertukar sumber data, ID dikirim sebagai
/users?id=123padahal kode membacareq.params.id. - Urutan route bertabrakan, route statis seperti
/users/newtertutup oleh/users/:idatau 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
- Cek path route. Pastikan ada titik dua, contoh
/users/:id. - Samakan nama param. Kalau route
:id, bacareq.params.id, bukanreq.params.userId. - Panggil URL dengan cara benar. Gunakan
/users/123untukreq.paramsdan/users?id=123hanya untukreq.query. - Cek urutan route. Daftarkan
/users/newsebelum/users/:idsupayanewtidak terbaca sebagai ID. - 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.