Formations — 1 037 leçons en français

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 :id qui 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 Allow listant 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.

Lire l'explication détaillée et faire le quiz →

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.