Accueil › Node.js › Un routeur à la main
Un routeur à la main
Un serveur HTTP sans frameworkdebutant
Un routeur est une liste de motifs essayés dans l'ordre. Rien de plus.
const routes = [
{ methode: "GET", motif: "/articles", action: lister },
{ methode: "POST", motif: "/articles", action: creer },
{ methode: "GET", motif: "/articles/:id", action: afficher },
];
L'appariement
function apparier(motif, chemin) {
const m = motif.split("/").filter(Boolean);
const c = chemin.split("/").filter(Boolean);
if (m.length !== c.length) return null;
const params = {};
for (let i = 0; i < m.length; i++) {
if (m[i].startsWith(":")) params[m[i].slice(1)] = decodeURIComponent(c[i]);
else if (m[i] !== c[i]) return null;
}
return params;
}
Le répartiteur
createServer((req, res) => {
const url = new URL(req.url, `http://${req.headers.host}`);
const methodesPossibles = [];
for (const route of routes) {
const params = apparier(route.motif, url.pathname);
if (!params) continue;
if (route.methode !== req.method) {
methodesPossibles.push(route.methode);
continue;
}
return route.action(req, res, params);
}
if (methodesPossibles.length > 0) {
res.writeHead(405, { allow: methodesPossibles.join(", ") }).end();
return;
}
res.writeHead(404).end();
}).listen(3000);
Les deux règles
Le plus spécifique d'abord : /articles/nouveau doit être déclaré avant
/articles/:id, sinon il ne sera jamais atteint. 405, pas 404, quand le
chemin existe mais pas la méthode.
C'est exactement ce qu'un framework automatise — avec les mêmes pièges d'ordre.
Les termes à connaître
- Route
Une méthode, un motif de chemin et une fonction. Un routeur n'est rien d'autre qu'une liste de ces triplets.
- Appariement dans l'ordre
Les routes sont essayées de la première à la dernière, et la première qui correspond gagne. L'ordre fait partie du comportement.
- Segment paramétré
Un segment comme
:idqui accepte n'importe quelle valeur et la capture. C'est ce qui rend un motif moins spécifique.- `405 Method Not Allowed`
Le chemin existe, la méthode non. Le statut exige l'en-tête
Allowlistant les méthodes acceptées.- `URLPattern`
L'API standard d'appariement de chemins, disponible globalement dans Node 24 et au-delà. Elle évite d'écrire son propre comparateur.
- Gestionnaire par défaut
La dernière branche, celle qui répond 404. Son absence laisse des requêtes sans réponse.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.