mitmario.dev

Warum Express?

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

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

Zwei Routen von Hand
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.

Dieselben zwei Routen mit Express
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

Darunter liegt weiterhin 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, 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.