Abschnitt 9 · Lektion 2
Die ersten Routen
In der if-Kette eines handgeschriebenen Servers fragt jede Route selbst nach Methode und Pfad.
Vergisst eine davon die Methode, beantwortet sie DELETE /notizen gleich mit, und niemand merkt es.
In Express steht an jeder Route nur noch, auf welche Methode und welchen Pfad sie hört.
express, get, post, listen
import express from "express";
const app = express();
app.get("/notizen", (req, res) => res.json({ anzahl: 2 }));
app.post("/notizen", (req, res) => res.status(201).json({ angelegt: true }));
app.get("/notizen/erste", (req, res) => res.json({ notiz: "Milch kaufen" }));
app.get("/", (req, res) => res.send("Notizbuch"));
app.listen(3000); express() erzeugt die Anwendung. app.get(pfad, funktion) legt eine Route für GET an,
app.post eine für POST, und so gibt es für jede Methode eine eigene Funktion. app.listen(port)
startet den Server. Es ist dasselbe listen wie in Abschnitt 8, denn darunter steckt dasselbe
Objekt.
Die Funktion an einer Route heißt Handler. Express ruft sie auf, wenn Methode und Pfad passen.
Sie bekommt req und res, wie gehabt. Neu ist nur, dass beides schon geprüft ist, wenn sie läuft.
Die ganze if-Kette aus Lektion 8.5 ist damit weg. Von außen, aus Sicht von fetch, hieß dieselbe
Adresse im JavaScript-Kurs Endpoint.
Im Reiter Browser steht /, also die letzte der vier Routen. Die anderen drei liegen in der
Befehlsleiste. Die POST-Route geht nur von dort, denn die Adresszeile schickt immer ein GET.
Von oben nach unten, die erste passende gewinnt
Neu ist die Regel eigentlich nicht. In der if-Kette aus Abschnitt 8 hat der erste Zweig
geantwortet, dessen Bedingung stimmte. Was darunter stand, kam nicht mehr dran. Express geht seine
Liste genauso der Reihe nach durch und nimmt die erste Route, die passt. Was danach kommt, sieht es
nie an.
Solange alle Pfade fest und verschieden sind, merkst du davon nichts. Ein app.use ohne Pfad oder
eine Route mit Platzhalter passt aber auf viele Adressen. Sobald zwei Einträge auf dieselbe Anfrage
passen, entscheidet allein die Reihenfolge.
import express from "express";
const app = express();
// Dieses app.use steht ganz oben und antwortet auf alles. Was darunter
// kommt, wird nie erreicht.
app.use((req, res) => res.send("ich war zuerst da"));
app.get("/notizen", (req, res) => res.json({ anzahl: 2 }));
app.listen(3000); app.use ohne Pfad passt auf jede Anfrage. Ganz oben notiert macht es alles darunter tot, und
zwar lautlos. Auf /notizen, wo laut Code eine Zahl stehen müsste, kommt trotzdem „ich war zuerst
da“. Wird eine Route partout nicht aufgerufen, obwohl sie richtig geschrieben ist, schaue ich zuerst
nach, was über ihr steht.
Der Standardfall
Express bringt einen 404 mit. Du hast ihn in Lektion 9.1 im Terminal gesehen. Für eine Seite ist er
in Ordnung, für eine API nicht. Er schickt eine kleine HTML-Seite, und ein Aufrufer, der JSON
erwartet und <!DOCTYPE html> bekommt, hat beim Auswerten ein Problem. Eine API bekommt deshalb
einen eigenen.
import express from "express";
// So steht es in aelteren Anleitungen, und seit Express 5 geht es nicht mehr.
try {
express().all("*", (req, res) => res.send("ok"));
} catch (fehler) {
console.log(`app.all("*") wirft: ${fehler.message.split(";")[0]}`);
}
const app = express();
app.get("/notizen", (req, res) => res.json({ anzahl: 2 }));
// Der eigene Standardfall: ein app.use ganz unten, ohne Pfad.
app.use((req, res) => res.status(404).json({ fehler: "nicht gefunden" }));
app.listen(3000); Das Mittel dafür ist dasselbe app.use ohne Pfad wie im Beispiel davor, nur eben ganz unten.
Steht es oben, verschluckt es alles. Steht es unten, kommt es dran, wenn keine Route gepasst hat.
/notizen antwortet wie gewohnt. Unter /nix kommt statt der Fehlerseite von Express jetzt dein
JSON, mit dem Statuscode 404 und dem Inhaltstyp application/json.
Eine Falle aus alten Anleitungen
Eine Zeile im Beispiel oben ist mit Absicht so stehen geblieben. app.all("*", ...) wirft seit
Express 5 einen Fehler. Im Terminal steht dazu hinter wirft: die Meldung
Missing parameter name at index 1: *. Auf Deutsch heißt das, dass hinter dem Stern an Stelle 1 des
Musters der Name eines Platzhalters fehlt.
Das ist ärgerlich, denn diese Zeile steht in vielen älteren Anleitungen. Sie stammt aus Express 4,
wo * ein gültiges Muster war. Express 5 benutzt eine neuere Fassung des Pfad-Übersetzers, und der
verlangt, dass ein Platzhalter einen Namen hat. app.all("/{*splat}", ...) funktioniert. Die
kürzere Form "/*splat" nimmt / selbst nicht mit. Bei einer Anleitung aus dem Netz schaue ich
deshalb zuerst nach, für welche Hauptversion sie geschrieben ist. In diesem Kurs ist es Express 5.
Der Fehler kommt beim Anlegen der Route, also sofort beim Start und nicht erst bei einer Anfrage, und deshalb steht die abgefangene Meldung im Terminal, obwohl niemand den Server gefragt hat. Das ist die freundliche Variante. So fällt es beim ersten Ausführen auf und nicht einem Nutzer im Betrieb.
Am einfachsten nimmt man für den Standardfall gar kein Muster, sondern app.use ohne Pfad. Das
sieht in beiden Versionen gleich aus.
In der Aufgabe bekommt eine kleine Einkaufsliste vier Routen und einen Standardfall, der JSON schickt.
Zum Mitnehmen
Express geht die Routen in der Reihenfolge durch, in der sie im Code stehen, und die erste passende antwortet. Ein eigener Standardfall ist deshalb ein app.use ohne Pfad ganz unten, und app.all mit nacktem Stern wirft in Express 5 schon beim Start einen Fehler.
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.