Filter URL Tidak Terbaca? Ini Cara Mengatasi Express Req Query Undefined

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.query untuk /produk?search=laptop&page=2.
  • req.params untuk /produk/:id.
  • req.body untuk data POST atau PUT, butuh express.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

  1. Minta client membuka URL lengkap, contoh /produk?search=laptop&page=2&limit=10.
  2. Samakan nama key di client dan server, termasuk huruf besar dan kecil.
  3. Beri default value supaya undefined tidak masuk ke database atau logika filter.
  4. Konversi string ke number untuk page dan limit, 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 search sebagai string kosong bila tidak dikirim.
  • Pastikan page bilangan bulat mulai dari 1.
  • Batasi limit agar 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.