mitmario.dev

Synthese: dieselbe Seite mit Express

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

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

Der Server aus Abschnitt 8
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.

Derselbe Server mit Express
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

Was Express nicht abnimmt
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, 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.