Abschnitt 9 · Lektion 1
Warum Express?
Mit node:http macht ein Server in jeder Route dasselbe. Er zerlegt die Adresse, vergleicht Methode
und Pfad, setzt Kopfzeilen, wandelt den Inhalt um und endet mit res.end und return. Bei zehn
Routen ist das meiste davon Wiederholung. Und in jeder Wiederholung kann ein return fehlen oder
ein Inhaltstyp falsch sein.
Derselbe Server, zweimal
import { createServer } from "node:http";
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("Guten Tag");
return;
}
if (req.method === "GET" && pfad === "/api/zeit") {
res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
res.end(JSON.stringify({ stunde: 12 }));
return;
}
res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
res.end("nicht gefunden");
});
server.listen(3000); Das ist Abschnitt 8 in klein, mit dem Standardfall ganz unten.
import express from "express";
const app = express();
app.get("/", (req, res) => res.send("Guten Tag"));
app.get("/api/zeit", (req, res) => res.json({ stunde: 12 }));
app.listen(3000); Zwei Zeilen für dasselbe. Und es sind nicht nur weniger Zeichen. Der Content-Type ist gesetzt,
ohne dass jemand ihn genannt hat. JSON.stringify steht nirgends, und der Standardfall ist da,
obwohl niemand ihn geschrieben hat. Keine Route braucht hier ein return, weil jede nur aus einer
Zeile besteht. Express selbst ist ein Paket wie slugify aus Abschnitt 5. Zu Hause kommt es mit
npm install dazu, wie in der Lektion „Node auf deinem Rechner“.
Im Reiter Browser sehen beide gleich aus, es ist ja derselbe Server. Der Unterschied steckt im
Standardfall, also in der Antwort auf einen Pfad, den keine Route bedient, und für beide Beispiele
liegt dafür curl -si http://localhost:3000/nix in der Befehlsleiste.
Der handgeschriebene Server antwortet mit text/plain, weil sein Code den Typ so setzt. Express
antwortet mit text/html, weil sein eingebauter Standardfall eine kleine Fehlerseite schickt. Bei
einer API ersetzt man ihn deshalb meistens. Wie das geht, steht in Lektion 9.2.
Was Express dir abnimmt
- Routing, auch mit Platzhaltern im Pfad.
- Den Standardfall, wenn keine Route passt.
- Inhaltstypen, passend zu dem, was du sendest.
- JSON senden, in einem Aufruf statt in dreien.
- Statische Dateien aus einem Ordner, ohne eine Route je Datei.
- Den Rumpf lesen, also alles, was ein Aufrufer mitschickt. Das ist Abschnitt 10.
Was Express nicht ist
Express ist kein Framework mit Meinung. Es schreibt dir keine Ordnerstruktur vor und bringt
keinen Datenbankzugriff mit, keine Vorlagensprache, keine Anmeldung, keine Konfiguration. Für
Vorlagen gibt es zwar res.render, aber die Sprache dazu kommt aus einem eigenen Paket. Express
kümmert sich um den Weg von der Anfrage zur Antwort. Alles andere entscheidest du.
Das ist gleichzeitig seine Stärke und der Grund, warum zwei Express-Projekte selten gleich aussehen. Wer sich in ein fremdes Express-Projekt einarbeitet, muss dessen Struktur lesen, statt sie zu kennen. In Abschnitt 18 komme ich darauf zurück und schlage eine vor.
Fastify löst dieselbe Aufgabe mit mehr Augenmerk auf Geschwindigkeit und mit eingebauter
Schema-Prüfung. Koa kommt von denselben Leuten wie Express, ist kleiner und baut ganz auf async.
Nest geht in die andere Richtung und bringt die Meinung mit, die Express fehlt, also Ordnerstruktur,
Dekoratoren und Dependency Injection. Wer Express versteht, findet sich in allen dreien schnell
zurecht, denn das Grundmuster ist überall dasselbe.
Es ist immer noch node:http
import express from "express";
import { Server, IncomingMessage, ServerResponse } from "node:http";
const app = express();
app.get("/", (req, res) => {
res.type("text/plain").send(
[
`req ist eine IncomingMessage: ${req instanceof IncomingMessage}`,
`res ist eine ServerResponse: ${res instanceof ServerResponse}`,
`req.url gibt es weiterhin: ${req.url}`,
`app.listen liefert einen http.Server: ${server instanceof Server}`,
].join("\n")
);
});
const server = app.listen(3000); Die Antwort besteht aus vier Zeilen, dreimal true und dazwischen /, der Pfad aus req.url.
app.listen gibt denselben http.Server zurück, den createServer geliefert hätte. req ist
dieselbe IncomingMessage, res dieselbe ServerResponse. Express hat nichts ersetzt, es hat
Methoden dazugehängt.
Alles aus Abschnitt 8 gilt deshalb weiter. req.headers ist da, res.setHeader ist da, res.end
ist da. Und wenn etwas nicht funktioniert, kannst du eine Ebene tiefer schauen. Ein Express-Server
ist ein node:http-Server mit einer Schicht darüber, und die Schicht darunter hast du in Abschnitt
8 selbst geschrieben.
In der Aufgabe liegt ein handgeschriebener Server mit zwei Routen, und du schreibst ihn mit Express noch einmal.
Zum Mitnehmen
Express spart die Handarbeit zwischen Anfrage und Antwort, vom Routing bis zum Standardfall. Darunter läuft weiterhin node:http, und req und res sind dieselben Objekte wie in Abschnitt 8, nur mit mehr Methoden.
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.