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 à
truedè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
Acceptdu client et ses facteurs de qualité.
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.