Formations — 1 037 leçons en français

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 modifier req et res, terminer la réponse, passer la main avec next(), ou signaler une erreur avec next(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.use et 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éclenche fn que pour les chemins commençant par /api. Le préfixe est retiré de req.url à l'intérieur ; req.originalUrl garde 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.

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.