mitmario.dev

Antworten senden

Node.js Sandbox 3 Min Lesezeit 3 BeispieleLektion 4 von 7

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

Fünf Wege, eine Antwort zu schicken
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 gibt res zurück, deshalb lässt es sich davor ketten, etwa res.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 auch res.sendStatus(204). Ich schreibe die 204 lieber als res.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

Was res.json zusätzlich erledigt
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.

Das vergessene return
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, kostenlos

Zu 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.