Abschnitt 8 · Lektion 4
Statuscode und Kopfzeilen setzen
Manche Server antworten auf alles mit 200. Auch auf eine Adresse, die es nicht gibt, oder auf eine Anfrage, der ein Pflichtfeld fehlt. Damit lassen sie jeden Aufrufer raten. Ein Programm, das deinen Server benutzt, liest den Text der Antwort oft gar nicht. Es schaut auf den Statuscode, und der ist das Erste, was es von deiner Antwort sieht.
Vier Gruppen von Statuscodes
2xxheißt „hat geklappt“.3xxheißt „sieh woanders nach“.4xxheißt „du hast einen Fehler gemacht“.5xxheißt „ich habe einen Fehler gemacht“.
Diese vier Sätze tragen erstaunlich weit. Am interessantesten ist die Grenze zwischen 4xx und 5xx, denn sie beantwortet die Frage, wer das Problem beheben muss.
Zehn für den Anfang
| Code | heißt |
|---|---|
| 200 OK | „hat geklappt, hier ist das Ergebnis“ |
| 201 Created | „hat geklappt, und dabei ist etwas Neues entstanden“ |
| 204 No Content | „hat geklappt, und zurückzugeben gibt es nichts“, etwa nach einem Löschen |
| 301 Moved Permanently | „das liegt ab jetzt woanders, nimm künftig die neue Adresse“ |
| 302 Found | „das liegt gerade woanders, frag nächstes Mal wieder hier“ |
| 400 Bad Request | „deine Anfrage ergibt keinen Sinn“ |
| 401 Unauthorized | „ich weiß nicht, wer du bist“ |
| 403 Forbidden | „ich weiß, wer du bist, und du darfst das nicht“ |
| 404 Not Found | „so etwas gibt es hier nicht“ |
| 500 Internal Server Error | „bei mir ist etwas kaputtgegangen“ |
Zwischen 401 und 403 liegt der feinste Unterschied der Liste. 401 heißt melde dich an, 403 heißt melde dich ruhig an, es ändert nichts.
import { createServer } from "node:http";
const server = createServer((req, res) => {
if (req.url === "/gruss") {
res.statusCode = 200;
res.setHeader("Content-Type", "text/plain; charset=utf-8");
res.end("Grüß dich");
return;
}
if (req.url === "/leer") {
res.statusCode = 204;
res.end();
return;
}
// Dieselbe Sache in einem Aufruf statt in zweien.
res.writeHead(404, { "Content-Type": "application/json" });
res.end(JSON.stringify({ fehler: "nicht gefunden" }));
});
server.listen(3000); Im Reiter Browser steht die Antwort auf /gruss, aber ohne den Statuscode. Ein Browser zeigt ihn
nirgends an, er richtet sich nur danach. Im Terminal steht er in der ersten Zeile. Je ein Befehl aus
der Befehlsleiste holt /gruss, /leer und /gibtsnicht.
Bei der 204 im zweiten Pfad steht weder Content-Type noch Content-Length in der Antwort. Den Typ
hat dort niemand gesetzt. Die Länge lässt Node bei einer 204 von sich aus weg, denn es gibt keinen
Rumpf. Mit /leer in der Adresszeile bleibt im Browser die Seite stehen, die vorher da war. Eine
204 sagt ihm, dass es nichts Neues gibt, und so behandelt er sie auch.
Zwei Schreibweisen für dieselbe Sache
Im Beispiel stehen beide nebeneinander. res.statusCode = 200 zusammen mit res.setHeader(...)
setzt die Angaben einzeln. res.writeHead(404, { ... }) setzt Status und Kopfzeilen in einem
Aufruf.
Welche du nimmst, ist Geschmack. Einen praktischen Unterschied gibt es aber, und der ist fein.
writeHead legt den Kopf sofort fest, setHeader sammelt ihn nur ein. Abgeschickt wird bei beiden
erst mit dem Rumpf. Bei setHeader kann Node deshalb noch Content-Length ausrechnen, sobald es
den Rumpf kennt. Nach writeHead steht der Kopf schon fertig da, und eine Länge kann Node dann
nicht mehr eintragen. Es behilft sich mit einem stückweisen Verfahren, das in der rohen Antwort als
Transfer-Encoding: chunked auftaucht, so wie bei /gibtsnicht. Für dich ändert sich dadurch
nichts. Aber wenn dir in einer rohen Antwort irgendwann die Längenangabe fehlt, weißt du jetzt,
woher das kommt.
Der Kopf muss vor dem Rumpf fertig sein
import { createServer } from "node:http";
const server = createServer((req, res) => {
res.write("der erste Teil\n");
// Der Kopf ist zu diesem Zeitpunkt laengst unterwegs. Was daraus
// wird, steht deshalb in der Antwort selbst, sonst saehe es niemand.
try {
res.setHeader("Content-Type", "text/plain");
res.write("die Kopfzeile wurde gesetzt\n");
} catch (fehler) {
res.write(`${fehler.name}: ${fehler.code}\n`);
}
res.end();
});
server.listen(3000); Sobald das erste Zeichen des Rumpfs unterwegs ist, ist der Kopf weg. Er steht ja davor. Ein
setHeader danach kommt zu spät, und Node sagt das deutlich. Im Reiter Browser steht in der zweiten
Zeile Error: ERR_HTTP_HEADERS_SENT. Dass die Antwort trotzdem ankommt, liegt am try im Beispiel.
Ohne das try fängt niemand den Fehler. Er beendet dann den ganzen Server, und die nächste Anfrage
findet niemanden mehr, der zuhört.
Dieser Fehlercode wird dich noch mehrfach besuchen, und die Ursache ist fast nie die, die du gerade
gesehen hast. Viel häufiger ist es ein writeHead oder setHeader nach einer Antwort, die schon
fertig ist. Meistens fehlt dann vor einer frühen Antwort ein return. Darum geht es in Lektion 9.4,
und dort ist es die Kernaufgabe.
Der Content-Type ist eine Behauptung
Der Content-Type sagt dem Empfänger, wie er den Rumpf lesen soll. Fehlt er, muss der Empfänger
raten. Browser sind darin gut, aber eben nicht unfehlbar. Und ein geratener Typ ist an einer Stelle
sogar ein Sicherheitsproblem. Wer eine hochgeladene Datei ohne Typangabe ausliefert, gibt dem
Browser die Gelegenheit, sie für HTML zu halten und auszuführen.
Und dann ist da noch der Zusatz hinter dem Semikolon.
import { createServer } from "node:http";
const server = createServer((req, res) => {
// Ohne charset, absichtlich. Mit "; charset=utf-8" dahinter muss
// der Browser nicht mehr raten.
res.setHeader("Content-Type", "text/plain");
res.end("Fröhliche Küche");
});
server.listen(3000); Fünfzehn Zeichen, und curl -si http://localhost:3000/ verrät, wie viele Bytes daraus werden.
Content-Length: 17. Die beiden Umlaute brauchen je zwei Bytes. Das ist UTF-8, und Node schreibt
Text immer so heraus.
Am Schreiben liegt es also nicht, am Lesen schon. Ohne charset=utf-8 steht nirgends, wie diese
Bytes gemeint sind. Der Empfänger muss raten. Was im Reiter Browser steht, hängt deshalb nicht von
deinem Server ab, sondern vom Browser, und zwei Browser dürfen sich an dieser Stelle durchaus
verschieden entscheiden. Rät einer auf eine ältere Kodierung, steht dort Fröhliche Küche. Diesen
Zeichensalat hast du im Netz mit Sicherheit schon gesehen. Jetzt weißt du, welche fehlende Angabe
dahintersteckt.
Steht ; charset=utf-8 dahinter, rät niemand mehr. Ich schreibe deshalb bei Text immer
text/plain; charset=utf-8. Bei application/json braucht es den Zusatz nicht, dort ist UTF-8
vorgeschrieben.
Drei Pfade bekommen in der Aufgabe je ihren eigenen Statuscode.
Zum Mitnehmen
Der Statuscode sagt in einer Zahl, wie die Anfrage ausgegangen ist, und mit zehn davon kommt man weit. Status und Kopfzeilen werden gesetzt, bevor der Rumpf losgeht, und Text bekommt seinen Zeichensatz mit.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.