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
- 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.
- Un paramètre de chemin est toujours une chaîne.
req.params.idvaut"42", jamais42. - 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êtesGETdont 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
:idd'un motif. Express le place dansreq.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.
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.