Abschnitt 9 · Lektion 4
Antworten senden
Fehlt in einer handgeschriebenen Antwort der Content-Type, rät der Empfänger, was er bekommt.
Fehlt res.end, wartet er bis zu seiner Zeitgrenze. Statuscode, Inhaltstyp, Umwandeln und Senden
sind vier Handgriffe, und jeder davon lässt sich vergessen.
Die Methoden an res
import express from "express";
const app = express();
app.get("/text", (req, res) => res.send("nur Text"));
app.get("/daten", (req, res) => res.json({ anzahl: 2 }));
app.get("/fehlt", (req, res) => res.status(404).json({ fehler: "nicht da" }));
app.get("/leer", (req, res) => res.status(204).end());
app.get("/woanders", (req, res) => res.redirect("/text"));
app.listen(3000); res.json(daten)ist der Normalfall für alles, was Daten sind. Es wandelt um und setzt den Inhaltstyp.res.send(text)ist der Normalfall für Text und HTML.res.status(code)setzt den Statuscode und gibtreszurück, deshalb lässt es sich davor ketten, etwares.status(404).json(...). Geschickt wird damit allein noch nichts.res.status(204).end()schickt einen Code ohne Rumpf, so wie nach einem erfolgreichen Löschen. Express kennt dafür auchres.sendStatus(204). Ich schreibe die 204 lieber alsres.status(204).end(), weil daran sichtbar bleibt, dass kein Rumpf folgt.res.redirect(ziel)schickt eine Weiterleitung, standardmäßig mit 302.
Alle fünf Routen stehen in derselben Datei, und im Reiter Browser ist /text geladen. Mit
/woanders passiert im Browser, was bei einer Weiterleitung passieren soll. Der Browser landet auf
/text, und in der Adresszeile steht danach auch /text. Wie die Weiterleitung selbst aussieht,
siehst du mit dem ersten Befehl der Befehlsleiste im Terminal, denn curl folgt ihr nicht von
allein. Der zweite zeigt die 204 ohne Rumpf.
res.send mit einem Text antwortet als text/html, nicht als text/plain. Das ist eine alte
Festlegung von Express und meistens auch richtig, weil man in eine Antwort mit res.send in der
Regel Markup hineinschreibt und kein reines Textdokument. Reinen Text gibt es mit
res.type("text/plain") davor.
Was res.json abnimmt
import express from "express";
const app = express();
// So ging es in 8.4, von Hand. In Express geht es immer noch, denn
// res ist dieselbe ServerResponse wie dort.
app.get("/von-hand", (req, res) => {
res.statusCode = 200;
res.setHeader("Content-Type", "application/json; charset=utf-8");
res.end(JSON.stringify({ anzahl: 2 }));
});
// Und so geht es jetzt.
app.get("/mit-express", (req, res) => res.json({ anzahl: 2 }));
app.listen(3000); Beide Routen schicken denselben Rumpf, die eine von Hand wie in Abschnitt 8, die andere mit einem Aufruf.
Ihre Köpfe unterscheiden sich in einer Zeile. res.json hängt ein ETag an, ein Kürzel, an dem ein
Browser später erkennt, ob sich die Antwort geändert hat. Was er damit anfängt, steht bei den
statischen Dateien in der nächsten Lektion. Sonst stehen dieselben Kopfzeilen da, nur
Content-Length an anderer Stelle. Express setzt die Länge selbst, und bei der Handarbeit hängt
Node sie ganz hinten an.
Hier zahlt sich die Handarbeit aus Abschnitt 8 aus. Du siehst nicht nur, dass res.json kürzer ist,
sondern welche drei Zeilen es ersetzt. Und den Inhaltstyp kannst du jederzeit selbst
überschreiben, denn res.setHeader ist immer noch da.
Eine Antwort pro Anfrage
Die Regel klingt so selbstverständlich, dass man sie überliest.
Eine HTTP-Antwort besteht aus Statuszeile, Kopfzeilen, Leerzeile und Rumpf, in dieser Reihenfolge.
Sobald das erste Zeichen unterwegs ist, ist der Kopf weg. Ein zweites res.json müsste also
Kopfzeilen setzen, die längst gesendet sind, und deshalb wirft es ERR_HTTP_HEADERS_SENT. Es ist
derselbe Fehler wie in Lektion 8.4, nur mit einer anderen Ursache.
import express from "express";
const app = express();
const titel = ["Die Verwandlung", "Der Prozess", "Das Schloss"];
app.get("/suche", (req, res) => {
// req.query sind die Query-Parameter aus 8.6, schon zerlegt.
const begriff = req.query.q ?? "";
if (begriff === "") {
// Hier fehlt ein return.
res.status(400).json({ fehler: "Ohne Suchbegriff gibt es nichts zu finden." });
}
res.json({ treffer: titel.filter((eintrag) => eintrag.includes(begriff)) });
});
app.listen(3000); Von außen sieht alles richtig aus. Im Reiter Browser steht für /suche ohne Begriff die
passende Meldung. Der Aufrufer merkt nichts, ein Test auf den Statuscode besteht, die Anwendung
funktioniert scheinbar. Nur im Protokoll des Servers steht eine Fehlermeldung, und dort sucht man
erst, wenn etwas kaputt ist. Beim Beispiel siehst du dieses Protokoll nirgends. In der Aufgabe
dieser Lektion läuft der Server beim Prüfen im Terminal, und dort steht dann die Meldung:
Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client
Mit ?q=Pro kommt sie gar nicht erst.
Der Zweig mit der Prüfung hat geantwortet, aber die Funktion lief danach weiter.
res.status(400).json(...) ist ein Aufruf und kein Sprung. Weiter unten kam dann res.json und
versuchte ein zweites Mal zu antworten.
Ein return davor löst es, und es ist wirklich nur das eine Wort.
return res.status(400).json(...) ist die übliche Schreibweise dafür. Der Rückgabewert interessiert
niemanden. Das return steht dort nur, um die Funktion zu verlassen.
Steht der Fehler irgendwann im Protokoll, suchst du deshalb nicht die Stelle, an der er geworfen wird. Gesucht ist der Zweig darüber, der geantwortet hat, ohne aufzuhören.
Von außen antwortet /teilen in der Aufgabe richtig, und im Terminal steht trotzdem ein Fehler.
Zum Mitnehmen
res.json schickt Daten samt Inhaltstyp, res.send Text und HTML, und res.status kommt davor. Nach einer frühen Antwort gehört ein return, sonst antwortet die Route ein zweites Mal und hinterlässt ERR_HTTP_HEADERS_SENT im Protokoll.
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.