Cara paling aman fetch API dengan query parameter di JavaScript adalah memakai URLSearchParams, bukan menggabung string manual dengan ? dan &. Penggabungan manual mudah rusak saat keyword berisi spasi, &, ?, atau #. URLSearchParams mengurus encoding otomatis sehingga server menerima nilai apa adanya.
Bangun URL Query yang Benar dengan URLSearchParams
Kode ini berjalan di browser modern dan Node.js 18 ke atas karena fetch dan URL sudah tersedia di kedua runtime. Jangan campur dengan require atau fs bila kamu menulis kode frontend.
- Siapkan base URL endpoint, misalnya https://api.example.com/products.
- Buat objek URLSearchParams berisi page, limit, dan keyword.
- Tempel query ke URL dengan url.search, lalu panggil fetch(url).
- Cek response.ok sebelum memanggil response.json().
const url = new URL("https://api.example.com/products");
url.search = new URLSearchParams({
page: "1",
limit: "10",
keyword: "kopi susu & gula"
});
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
const data = await response.json();
console.log(data);
Properti url.search menghasilkan ?page=1&limit=10&keyword=kopi+susu+%26+gula. Spasi dan & terkode otomatis, jadi filter pencarian tidak terpotong.
Tabel Cara Mengirim Query Parameter di Fetch
Pilih metode berdasarkan seberapa kompleks parameter yang kamu kirim.
| Metode | Cocok Untuk | Catatan |
|---|---|---|
| String manual | Satu parameter sederhana | Rawan salah encoding untuk spasi dan simbol |
| URLSearchParams | Filter, paging, pencarian | Encoding otomatis dan mudah dibaca |
| URL object | URL dinamis | Menggabung path dan query tanpa salah tanda tanya |
- Fetch hanya reject saat network error, bukan saat status 404 atau 500.
- Selalu periksa response.ok atau response.status setelah request selesai.
- Untuk method POST, query tetap boleh dipakai untuk filter, sedangkan data utama taruh di body.
Cek Hasil dan Perbaiki Parameter yang Tidak Terbaca
Buka tab Network di DevTools dan lihat URL request yang terkirim. Itu cara tercepat memastikan parameter benar-benar pergi.
- Server menerima nilai kosong, biasanya karena state input belum terisi saat fetch dipanggil.
- Spasi atau & terpotong, biasanya karena string manual tanpa encoding.
- Filter tidak jalan, biasanya karena nama parameter salah huruf, misalnya keyword tertulis q.
- Hapus key yang nilainya kosong sebelum membuat URLSearchParams.
Jangan taruh secret API key di URL frontend publik karena siapa pun bisa melihatnya dari Network dan riwayat browser. Simpan secret di backend dan biarkan frontend memanggil backend tersebut.
FAQ
Apakah query parameter sama dengan body POST?
Tidak. Query menempel di URL untuk filter dan paging, sedangkan body membawa data utama request POST.
Kenapa API tidak membaca query yang saya kirim?
Periksa ejaan nama parameter, encoding karakter khusus, dan pastikan nilai tidak kosong.
Bagaimana mengirim array lewat query parameter?
Gunakan params.append(“tag”, “a”) berulang untuk format ?tag=a&tag=b sesuai aturan API tujuan.