Cara membuat route parameter Express Node.js cukup tulis titik dua di depan nama segmen, contoh /users/:id, lalu baca nilainya lewat req.params.id. Kesalahan yang paling sering terjadi bukan di kode, tapi menulis pola route tanpa titik dua sehingga Express tidak pernah menangkap ID tersebut.
Kebutuhan Proyek Route Parameter Ini
Route parameter cocok untuk akses resource berdasarkan identitas, misalnya detail user atau produk. Nilai ini berbeda dari query dan body.
- Node.js dan Express sudah terinstal di proyek CommonJS dengan require.
- Paham beda req.params untuk segmen URL, req.query untuk ?key=value, dan req.body untuk data kiriman.
- Satu file app.js minimal tanpa database atau auth tambahan.
- Alat uji seperti curl atau Postman untuk cek respons JSON.
Langkah Membuat Route Parameter Express yang Terbaca
Ikuti urutan ini agar pola route langsung terbaca Express:
- Jalankan npm install express di folder proyek.
- Buat file app.js dan inisialisasi Express dengan const app = express().
- Tulis route app.get(‘/users/:id’, …) untuk menangkap satu ID.
- Ambil nilainya dengan req.params.id dan validasi sebelum dipakai.
- Jalankan dengan node app.js, lalu uji /users/12 dan /users/abc.
const express = require('express');
const app = express();
app.get('/users/:id', (req, res) => {
const { id } = req.params;
if (!id || id.length > 20) {
return res.status(400).json({ error: 'ID tidak valid' });
}
res.json({ id, message: `User ${id} ditemukan` });
});
app.listen(3000);
Untuk banyak parameter gunakan /products/:category/:id dan baca lewat req.params.category serta req.params.id. Untuk parameter opsional gunakan tanda tanya, contoh /articles/:slug?, sehingga route tetap jalan walau slug kosong.
Tabel Komponen Route Parameter dan Fungsinya
| Komponen | Fungsi | Contoh |
|---|---|---|
| :id | Menangkap segmen URL dinamis | /users/:id |
| req.params | Membaca nilai parameter | req.params.id |
| Validasi | Mencegah ID kosong atau salah format | cek panjang dan pola ID |
Error Cannot GET /users/12 biasanya berarti pola route tertulis /users/id tanpa titik dua, atau server belum direstart setelah route diubah.
FAQ
Bagaimana cara membaca banyak route parameter sekaligus?
Gunakan objek req.params, misalnya const { category, id } = req.params.
Apa beda route parameter dan query parameter?
Route parameter menjadi bagian path seperti /users/5, sedangkan query parameter menjadi tambahan filter seperti /users?role=admin.
Kenapa req.params kosong padahal URL sudah benar?
Kemungkinan nama properti salah dibaca atau route tertutup oleh route statis lain yang cocok lebih dulu.