mitmario.dev

Synthese: die eigene Kette

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

Protokoll, Rumpf lesen, statische Dateien, Router, Standardfall und Fehler-Handler funktionieren jeder für sich. Stehen sie zusammen in einer Datei, hängt alles daran, wo. Rutscht der Standardfall eine Zeile zu weit nach oben, bekommt jede Anfrage einen 404, und der Server meldet nichts davon.

Die sechs Glieder

Die vier Glieder in der Mitte
import express from "express";
import apiRouter from "./routen/api.js";

const app = express();

// Rumpf lesen, bevor irgendeine Route ihn braucht.
app.use(express.json());

// Statische Dateien: was hier liegt, braucht keine Route.
app.use(express.static("public"));

// Die eigenen Routen.
app.use("/api", apiRouter);

// Standardfall: greift, wenn bis hierhin niemand zustaendig war.
app.use((req, res) => res.status(404).json({ fehler: "nicht gefunden" }));

app.listen(3000);

Im Reiter Browser steht die Startseite aus public/, und niemand hat eine Route dafür geschrieben. /api/buecher und /nix gehen auch über die Adresszeile, der POST nur über das Terminal.

Im Beispiel stehen die vier Glieder in der Mitte. Darüber gehört noch das Protokoll und darunter der Fehler-Handler, beide aus den Lektionen davor. Jede Position hat einen Grund:

  • Das Protokoll steht oben, weil es alles sehen soll. Auch die Anfragen, die gleich im 404 landen, und besonders die, die einen Fehler auslösen. Weiter unten sieht ein Protokollant nur noch, was bis dorthin durchgekommen ist, und ausgerechnet die interessanten Fälle kommen nicht so weit.
  • Das Lesen des Rumpfs steht über den Routen, weil req.body sonst undefined ist, wenn eine Route ihn braucht. Bei einer POST-Route kommt dann partout nichts an.
  • Statische Dateien stehen über den Routen, damit eine Datei nicht erst durch die ganze Routenlogik läuft, bevor sie ausgeliefert wird. Soll eine Route dieselbe Adresse bedienen wie eine Datei, stehen die beiden Zeilen nach der Ausnahme aus Lektion 9.5 bewusst andersherum und bekommen einen Kommentar.
  • Die Routen stehen in der Mitte, weil sie die eigentliche Arbeit sind.
  • Der Standardfall steht unter allem, was antworten könnte. Er passt auf jede Anfrage und darf deshalb erst dran sein, wenn wirklich niemand mehr zuständig war.
  • Der Fehler-Handler steht ganz unten, weil nur er von dort etwas entgegennehmen kann. Alles, was über ihm schiefgeht, landet bei ihm.

Was passiert, wenn du eins verschiebst

Der Standardfall an der falschen Stelle
import express from "express";
import apiRouter from "./routen/api.js";

const app = express();

// Der Standardfall steht zu weit oben. Er passt auf jede Anfrage, also ist ab
// hier alles ein 404, und niemand merkt es an einer Fehlermeldung.
app.use((req, res) => res.status(404).json({ fehler: "nicht gefunden" }));

app.use(express.static("public"));
app.use("/api", apiRouter);

app.listen(3000);

Die Anwendung ist dieselbe, nur eine Zeile ist verschoben. Statt <h1>Bücherei</h1> kommt jetzt {"fehler":"nicht gefunden"} aus dem Standardfall, und /api/buecher bekommt dasselbe. Der Server läuft weiter, er tut nur nichts mehr.

Das ist die Sorte Fehler, die einen Nachmittag kostet, wenn man das Prinzip nicht kennt, und dreißig Sekunden, wenn man es kennt.

Eine hängende Anfrage finden

Der zweite typische Fall ist der aus Lektion 10.1, bei dem gar keine Antwort kommt.

So findest du eine hängende Anfrage
import express from "express";

const app = express();

// Wenn eine Anfrage haengt, protokollierst du jedes Glied einzeln. Die letzte
// Zeile, die noch kommt, steht direkt ueber der Stelle mit dem Fehler.
const protokoll = [];

// Diese Route steht ganz oben, damit du das Protokoll auch dann noch
// abrufen kannst, wenn die Kette darunter haengt.
app.get("/protokoll", (req, res) => res.json(protokoll));

app.use((req, res, next) => {
  protokoll.push("1 Protokoll");
  next();
});

app.use((req, res, next) => {
  protokoll.push("2 Rumpf lesen");
  next();
});

app.use((req, res, next) => {
  protokoll.push("3 Anmeldung prüfen");
  // Hier fehlt next(). Weiter kommt nichts.
});

app.use((req, res, next) => {
  protokoll.push("4 Routen");
  next();
});

app.listen(3000);

Die Methode ist unspektakulär und funktioniert immer. In jedes Glied kommt eine Ausgabe mit einer Nummer, und dann geht eine Anfrage hinein. Die letzte Zeile, die noch erscheint, steht direkt über der Stelle, an der es klemmt.

Die Anfrage auf /daten hängt, die Seite lädt und lädt. Mit /protokoll in der Adresszeile siehst du die Liste, und sie hört nach Glied 3 auf. Dort fehlt das next(), und Glied 4 kommt nie dran.

Die Route für das Protokoll steht in diesem Beispiel ganz oben, sonst hinge sie genauso fest wie /daten und könnte die Liste gar nicht mehr ausliefern. In einer echten Anwendung nimmt man statt einer Liste einfach console.log und schaut ins Terminal.

Dieselbe Technik hilft auch bei dem Fall darüber. Kommt eine Zeile nicht mehr, weil weiter oben schon geantwortet wurde, sieht man das an derselben Nummernfolge.

Zwei Fragen, die die Position verraten

Für eine neue Middleware stelle ich mir zwei Fragen:

  • Was muss vorher schon passiert sein? Eine Middleware, die req.body liest, gehört unter express.json(), eine, die die Anmeldung prüft, über die Routen, die sie schützen soll.
  • Soll sie auch dann noch laufen, wenn schon geantwortet wurde? Dann gehört sie nicht in die Kette, sondern in ein res.on("finish", ...). Deshalb ist die Zeitmessung einer eigenen Middleware zweigeteilt.

Im Reiter Praxis wird daraus die ganze Kette mit sechs Gliedern, von denen du drei selbst schreibst.

Zum Mitnehmen

Jedes Glied der Kette hat seinen Platz aus einem Grund, und verschoben verhält sich die ganze Anwendung anders. Hängt eine Anfrage oder gibt plötzlich alles 404, findet man die Stelle mit einer nummerierten Ausgabe je Glied.

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.