Cara membuat query parameter Express Node.js yang benar adalah membaca req.query di dalam route GET, lalu memberi nilai default dan validasi sebelum dipakai untuk pagination atau pencarian. URL seperti /produk?page=2&limit=10&search=kabel otomatis dipecah Express menjadi objek. Kesalahan yang paling sering terjadi adalah langsung memakai nilainya tanpa konversi angka, sehingga page + 1 menghasilkan 21 bukan 3.
Kebutuhan Sebelum Mulai
Pastikan proyek Express sudah berjalan dan route GET sudah aktif. Query hanya bekerja pada URL, jadi tidak perlu body parser.
- Express terinstal dan server berjalan dengan
app.listen. - Bedakan
req.queryuntuk?nama=nilai,req.paramsuntuk/produk/:id, danreq.bodyuntuk data POST atau PUT. - Siapkan URL uji seperti
/produk?page=2&limit=5&search=mouse.
Langkah Cara Membuat Query Parameter Express Node Js
- Buat route GET dengan path tanpa tanda tanya, contoh
app.get('/produk', ...). - Baca query lewat
req.querydan beri default memakai destructuring. - Konversi nilai angka dengan
Number()karena semua query masuk sebagai string. - Validasi batas nilai agar
pagekosong, nol, atau negatif tidak merusak logika. - Kirim respons JSON berisi nilai final yang dipakai aplikasi.
const express = require('express');
const app = express();
app.get('/produk', (req, res) => {
const { page = '1', limit = '10', search = '' } = req.query;
const pageNum = Number(page) || 1;
const limitNum = Number(limit) || 10;
if (pageNum < 1 || limitNum < 1) {
return res.status(400).json({ message: 'page dan limit harus lebih dari 0' });
}
res.json({
page: pageNum,
limit: limitNum,
search: search.trim()
});
});
app.listen(3000);
- Pagination:
?page=2&limit=10. - Filter:
?kategori=elektronik&stok=tersedia. - Sorting:
?sort=harga&order=asc. - Search:
?search=kabel+usb.
Tabel Perilaku req.query yang Wajib Dipahami
Semua nilai query bertipe string. Konversi manual wajib dilakukan untuk angka dan boolean.
| Pola URL | Hasil req.query | Catatan |
|---|---|---|
| ?page=2 | { page: ‘2’ } | Ubah ke Number sebelum hitung offset |
| ?tag=a&tag=b | { tag: [‘a’, ‘b’] } | Nama sama berulang menjadi array |
| ?filter[nama]=mouse | { filter: { nama: ‘mouse’ } } | Butuh parser extended untuk objek |
Validasi input kosong penting karena ?search= menghasilkan string kosong, bukan undefined. Periksa dengan trim() sebelum dipakai untuk filter database.
FAQ
Kenapa req.query undefined padahal URL ada tandanya?
Periksa route memakai app.get dan URL ditulis benar tanpa spasi setelah tanda tanya.
Bagaimana membaca query array seperti ?id=1&id=2?
Gunakan nama parameter sama berulang, Express akan memberi req.query.id berupa array.
Apakah query parameter cocok untuk data sensitif?
Tidak cocok karena URL tersimpan di log dan riwayat browser, gunakan body atau header untuk token dan kata sandi.