Filter URL tidak terbaca biasanya karena req.query.key yang kamu akses tidak ada di URL. Cek req.query dan req.originalUrl dulu, lalu samakan nama key dengan yang dikirim client. Di Express, req.query tidak butuh body parser.
Penyebab Req.Query Undefined di Express
req.query berisi object hasil parsing query string setelah tanda ?. Kalau URL tidak punya query string, hasilnya object kosong, jadi akses propertinya menghasilkan undefined.
Bedakan tiga sumber input ini:
req.queryuntuk/produk?search=laptop&page=2.req.paramsuntuk/produk/:id.req.bodyuntuk data POST atau PUT, butuhexpress.json().
Penyebab paling sering adalah typo key, misalnya kirim ?search= tapi baca req.query.q. Penyebab lain adalah akses properti bertingkat tanpa cek, misalnya req.query.filter.nama padahal filter tidak dikirim.
Urutan middleware jarang merusak req.query karena Express mem-parsing URL secara bawaan. Kalau kamu memakai proxy atau rewrite URL sendiri, pastikan req.originalUrl masih menyimpan query string aslinya.
Tabel Diagnosis Cepat Req.Query Undefined
Pasang dua baris log ini sebelum logika filter:
console.log(req.originalUrl);
console.log(req.query);
| Masalah | Penyebab | Solusi |
|---|---|---|
req.query kosong {} |
URL tanpa ? |
Cek req.originalUrl, perbaiki URL client |
Satu key undefined |
Nama key beda huruf besar kecil | Samakan key, misal search |
| Nilai angka sulit dihitung | Query selalu string | Konversi dengan Number() lalu validasi |
Langkah Memperbaiki Req.Query Undefined
- Minta client membuka URL lengkap, contoh
/produk?search=laptop&page=2&limit=10. - Samakan nama key di client dan server, termasuk huruf besar dan kecil.
- Beri default value supaya
undefinedtidak masuk ke database atau logika filter. - Konversi string ke number untuk
pagedanlimit, lalu tolak nilai tidak valid.
app.get('/produk', (req, res) => {
const search = req.query.search || '';
const page = Number(req.query.page || 1);
const limit = Number(req.query.limit || 10);
if (!Number.isInteger(page) || page < 1) {
return res.status(400).json({ message: 'page harus angka mulai dari 1' });
}
if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
return res.status(400).json({ message: 'limit harus 1 sampai 50' });
}
res.json({ search, page, limit });
});
Validasi sebelum dipakai ke logika:
- Pakai
searchsebagai string kosong bila tidak dikirim. - Pastikan
pagebilangan bulat mulai dari 1. - Batasi
limitagar query database tidak terlalu berat.
FAQ
Kenapa req.query kosong padahal URL ada tandanya?
Biasanya client mengirim ke path berbeda, atau tanda ? ter-encode. Cek req.originalUrl untuk melihat URL mentahnya.
Apakah req.query perlu middleware tambahan?
Tidak. Express sudah mem-parsing query string secara bawaan tanpa express.json().
Kenapa angka dari query jadi string?
Semua nilai query string memang string. Konversi manual memakai Number() lalu periksa hasilnya.