Express Router ve Routing: Route'lar, Parametreler, Önekler

Express'te routing bir HTTP metodunu ve bir path'i bir handler fonksiyonuyla eşleştirir: app.get('/users', handler) /users adresine gelen GET isteklerine cevap verir, app.post(), app.put() ve app.delete() da diğer metotlar için aynısını yapar. /users/:id örneğindeki gibi iki nokta ile başlayan bir parça bir route parametresidir ve değeri req.params içine düşer. Büyüyen bir uygulamayı düzenli tutmak için ilgili route'ları bir express.Router() içine koy ve onu app.use('/api', router) ile bir önek altına bağla.

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, {"id":2,"name":"Linus"} ile cevap verir. Route parametreleri her zaman string'dir, handler'ın Number(req.params.id) ile karşılaştırmasının nedeni bu. 201 almak için {"name": "Grace"} body'siyle POST /users gönder, sonra listenin değiştiğini görmek için DELETE /users/1 ve GET /users gönder.

Önekli express.Router()

Router, kendi route'ları ve middleware'i olan küçük bir uygulamadır. Path'leri görecelidir: /api/books altına bağlanmış bir router içinde /:id olarak yazılan bir route /api/books/:id adresine cevap verir. Gerçek bir projede her router kendi dosyasında durur ve module.exports = router ile biter.

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, {"id":1,"title":"Dune"} döndürür. router.route('/:id') path'i bir kez yazar ve her metot için bir handler zincirler; PUT /api/books/1 gönderirsen {"updated":"1"} alırsın. Bağlama path'ini /v2/books yap, aynı router bu sefer orada cevap verir.

Route sırası: ilk eşleşme kazanır

Express route'ları kaydettiğin sırayla dener ve response gönderen ilk route'ta durur. Parametreli bir route kendi konumundaki her şeyi yakalar, bu yüzden ondan sonra kaydedilen sabit bir path'e hiç ulaşılmaz:

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, {"route":"/users/:id","id":"new"} ile cevap verir: parametreli route önce kaydedildi ve isteği o aldı. /users/new route'unu /users/:id route'unun üstüne taşı ve {"route":"/users/new"} almak için tekrar çalıştır. Sonra en alttaki 404 handler'ına ulaşmak için GET /books gönder.

404 handler'ı

Express eşleşmeyen bir isteğe kendi HTML sayfasıyla, Cannot GET /books ile cevap verir. Bir API için genelde JSON istersin, bu yüzden yukarıdaki örnekte olduğu gibi en son route olarak path'siz bir app.use() ekle. Yalnızca önündeki her route isteği ilettiğinde çalışır. Handler'ların fırlattığı hatalar ise kendi dört argümanlı handler'ı olan farklı bir durumdur, onu Express error handling anlatıyor.

Express 5'te route path'leri

Express 5 path sözdizimini değiştirdi ve internetteki örneklerin çoğu Express 4 için yazılmış:

Tek başına bir * ya da bir parametreden sonra ?, route kaydedilirken bir TypeError fırlatır, bu yüzden uygulama başlamaz.

Sık yapılan hatalar

404 handler'ını en başa kaydetmek. Path'siz app.use() her şeyle eşleşir, bu yüzden her istek 404 alır. Onu en altta tut.

Önekin silindiğini unutmak. /api altına bağlanmış bir router içinde req.path, /api içermez. Tam path'e ihtiyacın olduğunda req.originalUrl kullan.

Bir parametreyi bir sayıyla karşılaştırmak. req.params.id === 1 her zaman false'tur, çünkü req.params.id '1' string'idir.