Formations — 1 037 leçons en français

Accueil › Node.js › Écrire la réponse

Écrire la réponse

Un serveur HTTP sans frameworkdebutant

Une réponse HTTP s'écrit dans un ordre imposé par le protocole : statut, en-têtes, corps.

res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
res.end(JSON.stringify({ nom: "Ada" }));

Ou en deux temps, quand les en-têtes se décident progressivement :

res.statusCode = 201;
res.setHeader("location", "/articles/42");
res.end();

Pourquoi l'ordre n'est pas négociable

Le statut et les en-têtes partent dans les premiers octets. Après eux, il n'y a plus moyen de revenir en arrière.

res.writeHead(200);
res.write("début de la page");
res.writeHead(500);          // ⛔ ERR_HTTP_HEADERS_SENT

D'où la garde à écrire dans tout traitement d'erreur :

if (res.headersSent) {
  res.destroy();             // on ne peut plus que couper
  return;
}
res.writeHead(500).end();

Dire la vérité avec le statut

Situation Statut
Créé 201 + en-tête location
Succès sans rien à renvoyer 204, aucun corps
Requête illisible 400
Requête lue, valeurs refusées 422
Introuvable, ou interdit de savoir 404
Conflit avec l'état actuel 409
Trop de requêtes 429 + retry-after

Les termes à connaître

`ServerResponse`

L'objet res. Un flux inscriptible auquel on donne d'abord un statut, puis des en-têtes, puis un corps — dans cet ordre, parce que c'est l'ordre du protocole.

`writeHead`

Écrit la ligne de statut et les en-têtes en une fois. Après son appel, les en-têtes sont figés.

`headersSent`

Passe à true dès que l'en-tête a quitté le processus. Le tester avant de répondre à une erreur évite un plantage à la place d'un message.

`res.end`

Termine la réponse. Sans lui, la connexion reste ouverte ; deux fois, c'est ERR_STREAM_WRITE_AFTER_END.

`201 Created`

La ressource a été créée. Accompagné de l'en-tête Location, qui dit où elle se trouve désormais.

`204 No Content`

Succès sans corps. Écrire quoi que ce soit après est une violation du protocole.

Négociation de contenu

Choisir la représentation à renvoyer d'après l'en-tête Accept du client et ses facteurs de qualité.

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.