Formations — 1 037 leçons en français

Accueil › Node.js › Routes et gestionnaires

Routes et gestionnaires

Express — les basesdebutant

Le chapitre précédent écrivait un serveur HTTP à la main : analyser l'URL, comparer la méthode, choisir un code de statut, sérialiser du JSON. Express fait ce travail, et seulement celui-là.

import express from "express";

const app = express();

app.get("/produits/:id", (req, res) => {
  res.json({ id: req.params.id });
});

app.listen(3000);

Ce qu'Express fait à votre place

L'appariement de la méthode et du chemin, l'extraction des paramètres, le Content-Type de la réponse, la sérialisation JSON, le code 404 par défaut.

Ce qu'il ne fait pas

Il ne valide rien, il ne sécurise rien, il n'authentifie personne, il ne limite aucun débit. Une application Express nue est un serveur HTTP sans aucune protection — c'est un routeur, pas un cadre de travail complet.

Trois règles dès la première route

app.get("/produits/nouveau", formulaire);   // littéral d'abord
app.get("/produits/:id", detail);           // paramétré ensuite
  1. Les routes sont essayées dans l'ordre de déclaration, et la première qui correspond gagne. Inverser ces deux lignes rend le formulaire inatteignable, sans aucun avertissement.
  2. Un paramètre de chemin est toujours une chaîne. req.params.id vaut "42", jamais 42.
  3. Un gestionnaire doit terminer la réponse ou passer la main. S'il ne fait ni l'un ni l'autre, la requête reste ouverte jusqu'au délai d'expiration du client.

app est elle-même une fonction (req, res) : app.listen(3000) ne fait que créer un serveur natif et la lui passer.

Les termes à connaître

Application Express

L'objet rendu par express(). C'est à la fois un registre de routes et une fonction (req, res) — on peut la passer directement à http.createServer, ce qui montre qu'Express ne remplace pas le serveur HTTP natif, il l'habille.

Route

L'association d'une méthode HTTP et d'un motif de chemin à une suite de fonctions. app.get("/produits/:id", h) ne répond qu'aux requêtes GET dont le chemin a deux segments.

Gestionnaire

La fonction (req, res) appelée quand la route correspond. Son unique devoir est de terminer la réponse, ou de passer la main. Tant qu'elle ne fait ni l'un ni l'autre, le client attend.

Paramètre de chemin

Le :id d'un motif. Express le place dans req.params.id, toujours sous forme de chaîne — même quand il ne contient que des chiffres.

Routeur (`express.Router`)

Une mini-application montable sur un préfixe. Elle a ses propres routes et ses propres intergiciels, ce qui permet de découper une API par ressource sans que tout vive dans un seul fichier.

Premier motif gagnant

Express parcourt les routes dans l'ordre de déclaration et s'arrête à la première qui correspond. Une route générale déclarée avant une route précise masque définitivement la précise.

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.