Accueil › Node.js › Les intergiciels, et l'ordre qui compte
Les intergiciels, et l'ordre qui compte
Express — les basesdebutant
Un intergiciel est une fonction appelée au passage d'une requête. Express les appelle dans l'ordre de déclaration — rien d'autre ne détermine la séquence.
app.use((req, res, next) => {
req.debut = Date.now();
next(); // passer la main
});
app.get("/sante", (req, res) => {
res.json({ ok: true }); // terminer
});
Trois sorties, et une seule à choisir
Chaque intergiciel doit faire exactement une de ces trois choses :
| Sortie | Écriture | Effet |
|---|---|---|
| passer la main | next() |
l'élément suivant de la chaîne est appelé |
| répondre | res.json(…) |
la chaîne s'arrête, le client est servi |
| signaler une erreur | next(err) |
saut direct au gestionnaire d'erreur |
La quatrième sortie, celle qui n'en est pas une
app.use((req, res, next) => {
if (!req.get("authorization")) return; // ⛔ ni réponse, ni next()
next();
});
Cette fonction ne lève rien, ne journalise rien et n'apparaît dans aucune métrique d'erreur. La requête reste simplement suspendue. Le seul symptôme est un client qui attend jusqu'à son délai d'expiration, puis abandonne. C'est le bogue le plus désorientant d'Express, parce qu'on le cherche dans le code qui n'a jamais été exécuté.
L'ordre type d'une application
app.use(helmet()); // en-têtes de sécurité
app.use(limiteur); // limitation de débit
app.use(express.json()); // analyse du corps
app.use("/api", routeur); // routes
app.use(nonTrouve); // 404
app.use(gestionnaireErreur); // quatre paramètres, toujours en dernier
Déplacer express.json() après les routes suffit à rendre req.body
inutilisable sans le moindre message d'avertissement.
Les termes à connaître
- Intergiciel
Une fonction
(req, res, next)placée dans la chaîne de traitement. Elle peut lire et modifierreqetres, terminer la réponse, passer la main avecnext(), ou signaler une erreur avecnext(err). Elle doit faire exactement l'une de ces trois choses.- Ordre de déclaration
Express appelle les intergiciels dans l'ordre où ils ont été enregistrés par
app.useet par les routes. Il n'y a aucune priorité, aucun tri, aucune phase : la position dans le fichier est la configuration.- `next()`
Le passage de main. Appelé sans argument, il donne le contrôle à l'élément suivant de la chaîne. Ne pas l'appeler et ne pas répondre laisse la requête suspendue — sans erreur, sans journal, jusqu'au délai d'expiration du client.
- `next(err)`
Le saut vers le gestionnaire d'erreur. Express ignore alors tous les intergiciels et routes ordinaires restants et ne cherche plus que des gestionnaires à quatre paramètres.
- Intergiciel de montage
app.use("/api", fn)ne déclenchefnque pour les chemins commençant par/api. Le préfixe est retiré dereq.urlà l'intérieur ;req.originalUrlgarde le chemin complet.- Requête suspendue
Une requête dont aucun intergiciel n'a répondu ni passé la main. Le serveur ne lève rien et ne journalise rien ; le seul symptôme visible est un client qui attend jusqu'à son délai d'expiration.
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.