Express Router dan Routing: Route, Params, Prefix

Routing di Express memetakan method HTTP dan path ke sebuah fungsi handler: app.get('/users', handler) menjawab request GET ke /users, dan app.post(), app.put(), serta app.delete() melakukan hal yang sama untuk method lainnya. Segmen yang diawali titik dua, seperti di /users/:id, adalah parameter route yang nilainya masuk ke req.params. Supaya aplikasi yang terus tumbuh tetap rapi, taruh route yang berkaitan dalam express.Router() lalu pasang di bawah prefix dengan app.use('/api', router).

const express = require('express');
const app = express();
app.use(express.json());

const users = [
    { id: 1, name: 'Ada' },
    { id: 2, name: 'Linus' },
];
let nextId = 3;

app.get('/users', (req, res) => {
    res.json(users);
});

// GET /users/2
app.get('/users/:id', (req, res) => {
    const user = users.find((u) => u.id === Number(req.params.id));
    if (!user) return res.status(404).json({ error: 'User not found' });
    res.json(user);
});

app.post('/users', (req, res) => {
    const user = { id: nextId++, name: req.body.name };
    users.push(user);
    res.status(201).json(user);
});

app.delete('/users/:id', (req, res) => {
    const index = users.findIndex((u) => u.id === Number(req.params.id));
    if (index === -1) return res.status(404).json({ error: 'User not found' });
    users.splice(index, 1);
    res.status(204).end();
});

app.listen(3000);

GET /users/2 menjawab {"id":2,"name":"Linus"}. Parameter route selalu berupa string, itulah sebabnya handler membandingkan dengan Number(req.params.id). Kirim POST /users dengan body {"name": "Grace"} untuk mendapat 201, lalu DELETE /users/1 dan GET /users untuk melihat daftarnya berubah.

express.Router() dengan prefix

Router adalah aplikasi mini dengan route dan middleware-nya sendiri. Path-nya relatif: route yang ditulis sebagai /:id di dalam router yang dipasang di /api/books menjawab /api/books/:id. Di proyek sungguhan, setiap router tinggal di file-nya sendiri dan diakhiri module.exports = router.

const express = require('express');

// routes/books.js
const books = express.Router();
const list = [{ id: 1, title: 'Dune' }];

books.get('/', (req, res) => {
    res.json(list);
});

books
    .route('/:id')
    .get((req, res) => {
        res.json(list.find((b) => b.id === Number(req.params.id)) ?? null);
    })
    .put((req, res) => {
        res.json({ updated: req.params.id });
    })
    .delete((req, res) => {
        res.json({ deleted: req.params.id });
    });

// server.js
const app = express();
app.use('/api/books', books);

// GET /api/books/1
app.listen(3000);

GET /api/books/1 mengembalikan {"id":1,"title":"Dune"}. router.route('/:id') menulis path-nya sekali dan merangkai satu handler per method; kirim PUT /api/books/1 dan kamu mendapat {"updated":"1"}. Ganti path pemasangannya menjadi /v2/books dan router yang sama menjawab di sana.

Urutan route: yang pertama cocok menang

Express mencoba route sesuai urutan pendaftarannya dan berhenti di route pertama yang mengirim response. Route dengan parameter menangkap apa saja di posisinya, jadi path tetap yang didaftarkan sesudahnya tidak pernah tercapai:

const express = require('express');
const app = express();

app.get('/users/:id', (req, res) => {
    res.json({ route: '/users/:id', id: req.params.id });
});

app.get('/users/new', (req, res) => {
    res.json({ route: '/users/new' });
});

// Runs only when no route above answered.
app.use((req, res) => {
    res.status(404).json({ error: `Cannot ${req.method} ${req.path}` });
});

// GET /users/new
app.listen(3000);

GET /users/new menjawab {"route":"/users/:id","id":"new"}: route dengan parameter didaftarkan lebih dulu dan mengambilnya. Pindahkan route /users/new ke atas /users/:id lalu jalankan lagi untuk mendapat {"route":"/users/new"}. Lalu kirim GET /books untuk mencapai handler 404 di bagian bawah.

Handler 404

Express menjawab request yang tidak cocok dengan halaman HTML miliknya sendiri, Cannot GET /books. Untuk API kamu biasanya ingin JSON, jadi tambahkan app.use() tanpa path sebagai route paling akhir, seperti di blok di atas. Handler ini berjalan hanya saat setiap route sebelumnya meneruskan request-nya. Error yang dilempar handler adalah kasus lain dengan handler empat argumennya sendiri, dibahas di penanganan error Express.

Path route di Express 5

Express 5 mengubah sintaks path, dan sebagian besar potongan kode di internet ditulis untuk Express 4:

* sendirian atau ? setelah parameter melempar TypeError saat route didaftarkan, jadi aplikasinya tidak mau jalan.

Kesalahan umum

Mendaftarkan handler 404 lebih dulu. app.use() tanpa path cocok dengan semuanya, jadi setiap request mendapat 404. Taruh di bagian paling bawah.

Lupa bahwa prefix-nya dibuang. Di dalam router yang dipasang di /api, req.path tidak menyertakan /api. Pakai req.originalUrl saat kamu butuh path lengkapnya.

Membandingkan parameter dengan angka. req.params.id === 1 selalu false karena req.params.id adalah string '1'.