Abschnitt 8 · Lektion 2
Die rohe Antwort
Im Reiter Browser steht nach einem Aufruf nur, was die Seite zeigt. Ob der Server mit 200 oder 404 geantwortet hat, steht dort nirgends. Auch nicht, welchen Inhaltstyp er angegeben hat oder ob er ein Cookie setzen wollte. Davon hängt aber ab, ob ein Server richtig arbeitet. Im Terminal lässt sich die Antwort so ansehen, wie sie über die Leitung geht, nämlich als Text.
Die vier Teile einer Antwort
import { createServer } from "node:http";
const server = createServer((req, res) => {
res.setHeader("Content-Type", "text/plain; charset=utf-8");
res.end("Guten Tag");
});
server.listen(3000); Die Seite zeigt zwei Wörter, und das ist ein Viertel der Geschichte. Die anderen drei Viertel stehen
davor. Der Browser zeigt sie nicht, weil sie nicht für dich gedacht sind. Im Terminal siehst du sie
mit curl -si http://localhost:3000/ aus der Befehlsleiste.
Ganz oben steht die Statuszeile mit Protokollversion, Statuscode und einem kurzen Text dazu. Nach dem Text soll sich kein Programm richten. Darunter kommen die Kopfzeilen (englisch header), je eine pro Zeile, Name und Wert durch einen Doppelpunkt getrennt. Dann eine Leerzeile. Und danach der Rumpf (englisch body), bei einer Seite das HTML, bei einer API das JSON.
Auf -i kommt es an, er nimmt den Kopf mit. Das -s nimmt nur den Fortschrittsbalken weg, den
curl sonst über die Antwort schreibt.
Die Leerzeile ist die wichtigste Zeile im ganzen HTTP-Protokoll. Nur an ihr erkennt der Empfänger, wo der Kopf aufhört und der Rumpf anfängt. Ohne sie gäbe es keine Möglichkeit, das eine vom anderen zu trennen. Ein Rumpf darf ja alles enthalten, auch etwas, das wie eine Kopfzeile aussieht.
Eines sieht man der Ausgabe nicht an. Jede dieser Zeilen endet auf der Leitung mit \r\n, also mit
Wagenrücklauf und Zeilenvorschub, und nicht mit einem einfachen Zeilenumbruch. Sichtbar wird das mit
curl -si http://localhost:3000/ | cat -A, denn cat -A zeichnet die unsichtbaren Zeichen mit.
Jetzt steht am Ende der Statuszeile und jeder Kopfzeile ^M$. Hinter Guten Tag steht nichts, denn
der Rumpf hört einfach auf. Das $ ist der Zeilenumbruch, das ^M der Wagenrücklauf davor. Die
berühmte Leerzeile besteht damit aus einem \r\n, vor dem nichts steht.
Vier der Kopfzeilen hat niemand gesetzt. Date, Connection, Keep-Alive und Content-Length
kommen von Node selbst. Die Länge rechnet es aus, sobald es den Rumpf kennt, und das Datum setzt es,
weil HTTP es so vorsieht. Die Datumszeile trägt den Zeitpunkt der Antwort. Sie ist deshalb die
einzige in dieser Ausgabe, die sich bei jedem Aufruf ändert.
Auf dem Hinweg genauso
Eine Anfrage ist genauso gebaut, nur stehen in ihrer ersten Zeile statt des Status die Methode, der
Pfad und die Version. Danach wieder Kopfzeilen, wieder eine Leerzeile und dann der Rumpf. Den gibt
es bei einem GET üblicherweise nicht.
Mit -v statt -i zeigt curl auch, was es selbst hinausgeschickt hat, und vor jeder Zeile steht
dann ein Zeichen, > für den Hinweg und < für den Rückweg. Beide Richtungen stehen untereinander.
Der Befehl dazu ist curl -sv http://localhost:3000/.
curl schickt drei Kopfzeilen, Host, User-Agent und Accept. Ein Browser schickt deutlich
mehr, mit den Sprachen, die du bevorzugst, den Kompressionsverfahren, die er versteht, und dem Namen
des Programms. Alles davon ist Text, und alles davon kommt vom Aufrufer. Was dein Server damit
anfängt, steht in der nächsten Lektion.
Auch Daten sind nur Text im Rumpf
import { createServer } from "node:http";
const server = createServer((req, res) => {
res.setHeader("Content-Type", "application/json");
res.end(JSON.stringify({ titel: "CSS", imBrowser: true }));
});
server.listen(3000); Eine JSON-Antwort ist keine andere Sorte Antwort. Dieselben vier Teile, und hinter der Leerzeile
steht Text, der zufällig als JSON gelesen werden kann. Vermerkt ist das an einer einzigen Stelle, in
der Kopfzeile Content-Type. Mit curl -si siehst du sie. Bis auf diese Zeile, die Länge und das
Datum ist die Antwort Zeile für Zeile so gebaut wie die aus dem ersten Beispiel.
Der Server schickt also Text und eine Behauptung darüber, was der Text ist. Ob der Empfänger sich daran hält, ob er die Behauptung überhaupt liest und ob sie stimmt, sind drei verschiedene Fragen. Was passiert, wenn sie fehlt, steht in Lektion 8.4.
curl als Werkzeug
curl funktioniert nicht nur bei den Beispielen. Deine eigene Antwort zeigt derselbe Befehl
genauso.
Ab hier ist das dein Werkzeug für alles, was der Reiter Browser nicht zeigt, also für Statuscodes,
Kopfzeilen, Weiterleitungen und Cookies. Im Browser siehst du das Ergebnis, mit curl den Weg
dorthin.
Diese Ansicht steht auch nach jedem Prüfen vor dir. Klappst du eine Prüfung mit einer Anfrage auf,
steht darin, was curl von deinem Server bekommen hat. Dafür läuft derselbe Befehl,
curl -s -i --max-time 5.
Im Reiter Netzwerk steht, was die Seite im Reiter Browser lädt, und in dieser Lektion ist das wenig. Zur Textantwort gibt es dort eine Zeile mit Pfad und Dauer, ohne Statuscode und ohne Kopfzeilen. Der Mitschnitt läuft nämlich in der Seite mit, die der Browser geladen hat, und eine Textantwort ist keine Seite. Ab Lektion 8.5 lieferst du HTML aus, und dann steht dort alles. Die Entwicklerwerkzeuge in deinem eigenen Browser haben denselben Reiter. Dort gibt es diese Grenze nicht, und zu jeder Anfrage steht alles da, auch zu einer, die nur Text zurückgibt.
In der Aufgabe bestimmst du alle vier Teile einer Antwort selbst.
Zum Mitnehmen
Eine HTTP-Antwort ist Text in fester Reihenfolge, Statuszeile, Kopfzeilen, eine leere Zeile und der Rumpf. Wo die erste leere Zeile steht, hört der Kopf auf und der Rumpf fängt an.
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 2 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.