Abschnitt 9 · Lektion 6
Synthese: dieselbe Seite mit Express
Ein Server von Hand mit einer Seite und einer kleinen API braucht 42 Zeilen, und an vielen davon
kann man sich vertun. Ein vergessenes return bringt ihn zum Absturz, ein vertippter Inhaltstyp
fällt erst beim Empfänger auf. Legst du seine Express-Fassung daneben, siehst du, wie viel davon
wegfällt und was bleibt.
Beide Fassungen nebeneinander
import { createServer } from "node:http";
const kurse = [
{ slug: "html", titel: "HTML" },
{ slug: "css", titel: "CSS" },
];
const server = createServer((req, res) => {
const pfad = new URL(req.url, "http://localhost").pathname;
if (req.method === "GET" && pfad === "/") {
res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
res.end("<h1>Kurse</h1>");
return;
}
if (req.method === "GET" && pfad === "/api/kurse") {
res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify({ anzahl: kurse.length, kurse }));
return;
}
if (req.method === "GET" && pfad.startsWith("/api/kurse/")) {
const slug = pfad.slice("/api/kurse/".length);
const kurs = kurse.find((eintrag) => eintrag.slug === slug);
if (kurs === undefined) {
res.writeHead(404, { "Content-Type": "application/json" });
res.end(JSON.stringify({ fehler: "Kurs nicht gefunden" }));
return;
}
res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify(kurs));
return;
}
res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
res.end("nicht gefunden");
});
server.listen(3000); Das ist die Fassung von Hand, mit zwei Kursen und dem Standardfall als Text.
import express from "express";
const kurse = [
{ slug: "html", titel: "HTML" },
{ slug: "css", titel: "CSS" },
];
const app = express();
app.get("/", (req, res) => res.send("<h1>Kurse</h1>"));
app.get("/api/kurse", (req, res) => res.json({ anzahl: kurse.length, kurse }));
// Den einzelnen Kurs unter /api/kurse/:slug baut die Aufgabe dieser Lektion.
app.use((req, res) => res.status(404).json({ fehler: "nicht gefunden" }));
app.listen(3000); Beide Beispiele laufen. Über den Reiter des Beispiels wechselst du zwischen ihnen, und die Seite
zieht nach. Mit /, /api/kurse und /nix lässt sich dreimal vergleichen. Den einzelnen Kurs
kennt nur die Fassung von Hand.
Zweimal kommt dieselbe Antwort, beim dritten Mal nicht. Der handgeschriebene Server sagt
nicht gefunden als Text, denn so steht es in seinem Standardfall. Die Express-Fassung antwortet
mit JSON, weil ein eigener Standardfall dort eine einzige Zeile ist.
Was weg ist
Interessanter als die Zeilen sind die Gelegenheiten, etwas falsch zu machen. Drei davon sind verschwunden.
Da ist zuerst das vergessene res.end. In der Fassung von Hand endet jeder Zweig mit res.end, und
vier davon brauchen danach ein return. Fehlt ein res.end, hängt die Anfrage. Fehlt ein return,
läuft der Zweig in das nächste writeHead, und der ganze Prozess stürzt mit ERR_HTTP_HEADERS_SENT
ab. In der Express-Fassung steht keins von beiden mehr.
Dann der fehlende Standardfall. Von Hand steht er ganz unten und ist leicht zu vergessen. Fehlt er, hängt jede unbekannte Adresse. Mit Express ist einer schon da, und wer ihn ersetzt, tut das mit einer bewussten Zeile.
Und der falsche Inhaltstyp. Von Hand wird er fünfmal gesetzt, und beim fünften Mal schreibt man
text/plan statt text/plain oder vergisst den Zeichensatz, was dann erst beim Empfänger auffällt.
Mit Express kommt er aus der Methode, die du ohnehin aufrufst.
Dazu fällt das Zerlegen des Pfads weg. Aus startsWith plus slice wird /api/kurse/:slug.
Was nicht weg ist
import express from "express";
const kurse = [{ slug: "css", titel: "CSS" }];
const app = express();
// Beide Routen sind gueltig, Express beschwert sich nicht. Trotzdem ist
// die Reihenfolge falsch, und das merkt nur, wer es ausprobiert.
app.get("/api/kurse/:slug", (req, res) => {
const kurs = kurse.find((eintrag) => eintrag.slug === req.params.slug);
if (kurs === undefined) return res.status(404).json({ fehler: "nicht gefunden" });
res.json(kurs);
});
app.get("/api/kurse/neu", (req, res) => res.json({ formular: true }));
app.listen(3000); Hier ist alles richtig geschrieben. Beide Routen sind gültig, und Express startet ohne Murren.
Trotzdem steht im Reiter Browser unter /api/kurse/neu ein nicht gefunden, und zwar für einen
Kurs, der nie gemeint war. /api/kurse/css funktioniert dabei tadellos. Der Fehler zeigt sich also
nur an der einen Adresse.
Express nimmt Tipparbeit und Flüchtigkeitsfehler ab, aber keine Entscheidung. Welche Routen es gibt, in welcher Reihenfolge sie stehen, welcher Statuscode passt und was bei einem Fehler zurückkommt, bleibt deine Sache.
Der Grund, warum dieser Kurs den Umweg genommen hat
Du hättest mit Abschnitt 9 anfangen können. Vier Zeilen, ein laufender Server, und in einer Nachmittagsstunde eine kleine API. So fangen viele Anleitungen an.
Der Preis dafür zeigt sich erst später, und zwar immer dann, wenn etwas nicht funktioniert. Warum
kommt die Antwort als HTML, wenn ich JSON erwarte? Warum hängt die Anfrage? Warum trifft meine Route
nicht? Wer nur app.get kennt, hat auf keine dieser Fragen einen Ansatz, denn er weiß nicht, was
app.get eigentlich tut.
Du weißt es. res.json ist setHeader plus JSON.stringify plus end. Eine Route ist ein
Vergleich von Methode und Pfad. Der Standardfall ist das, was nach dem letzten if übrig bleibt.
req und res sind dieselben Objekte wie in Abschnitt 8.
In der Aufgabe entsteht der ganze Server aus Lektion 8.7 noch einmal mit Express, samt der Startseite aus einem Ordner.
Zum Mitnehmen
Mit Express fallen das vergessene res.end, der fehlende Standardfall und der vertippte Inhaltstyp weg, und den Pfad zerlegt ein Platzhalter. Eine Route an der falschen Stelle meldet Express dagegen nicht.
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.