Abschnitt 9 · Lektion 5
Statische Dateien
Ein neues Bild im Ordner ist für einen handgeschriebenen Server erst einmal ein 404. Das bleibt so, bis jemand eine Route dafür schreibt und seine Endung in die Tabelle der Inhaltstypen einträgt. Bei einer Seite mit Stylesheet, Bildern und Schriften wiederholt sich das für jede Datei.
Ein Aufruf
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Startseite</title>
<link rel="stylesheet" href="stil.css">
</head>
<body>
<h1>Startseite</h1>
<p><a href="/api/status.json">/api/status.json</a></p>
</body>
</html> body {
color: teal;
} { "status": "ok" } import express from "express";
import { join } from "node:path";
const app = express();
// Ein Aufruf statt einer Route je Datei. Warum der Ordner mit join
// angegeben ist, zeigt das naechste Beispiel.
app.use(express.static(join(import.meta.dirname, "public")));
app.listen(3000); express.static(ordner) erzeugt eine Middleware, also eine Funktion, die vor den Routen sitzt und
jede Anfrage sieht. Ausführlich geht es in Abschnitt 10 darum. Diese hier sieht nach, ob im Ordner
eine passende Datei liegt. Wenn ja, schickt sie diese, sonst reicht sie weiter. Den Ordner gibt
join(import.meta.dirname, "public") an, also public neben der Datei selbst. Warum dort nicht
einfach "public" steht, siehst du im zweiten Beispiel.
Was dabei mitkommt, ohne dass es jemand hinschreibt:
- Der Inhaltstyp, anhand der Endung. Das ist die Tabelle aus dem handgeschriebenen Server, nur vollständig.
index.htmlals Startseite eines Verzeichnisses. Deshalb beantwortet der Server oben auch/, obwohl niemand eine Route dafür angelegt hat.- Unterordner, wie
/api/status.jsonzeigt. - Kopfzeilen für den Zwischenspeicher (englisch cache) des Browsers, darunter ein
ETagwie beires.json. Schickt der Browser das Kürzel beim nächsten Mal mit, kommt304 Not Modifiedohne Rumpf zurück, und er nimmt die Datei, die er schon hat.
Im Reiter Browser steht die Startseite in Teal. Der Browser hat also auch das Stylesheet geholt, ohne dass jemand eine Route dafür geschrieben hat. Im Reiter Netzwerk stehen beide Anfragen untereinander, die Seite und das Stylesheet. Der Link unter der Überschrift führt zum JSON im Unterordner.
Findet die Middleware nichts, reicht sie weiter und beendet die Kette nicht. Deshalb kannst du eigene Routen daneben betreiben. Passen beide auf dieselbe Adresse, entscheidet allerdings der Platz im Code. Auch hier gewinnt, was weiter oben steht.
Wo der Ordner liegt
body {
color: teal;
} import express from "express";
import { join } from "node:path";
// Der Prozess laeuft absichtlich aus dem Verzeichnis darueber, so als
// haette jemand "node unterordner/server.js" aufgerufen.
process.chdir("..");
const app = express();
// Relativ zum Arbeitsverzeichnis. Das ist jetzt ein anderes, also
// findet der Server nichts mehr und /stil.css gibt 404.
app.use(express.static("public"));
// Tausch die Zeile darueber gegen diese:
// app.use(express.static(join(import.meta.dirname, "public")));
app.listen(3000); express.static("public") ist relativ zum Arbeitsverzeichnis des Prozesses, nicht zur Datei, in
der es steht. Das ist dieselbe Regel wie bei den Dateipfaden aus Lektion 2.4. Hier hat sie zum
ersten Mal ernsthafte Folgen.
Solange node server.js im Projektordner startet, fällt beides zusammen und alles geht gut. Ruft
aber jemand node unterordner/server.js eine Ebene höher auf, liefert der Server plötzlich nichts
mehr aus, und dasselbe passiert, wenn ein Dienst das Programm mit einem anderen Arbeitsverzeichnis
startet. Ein Ordner, den es dort nicht gibt, ist für express.static einfach ein Ordner ohne
Treffer.
Heraus kommt die Fehlerseite von Express, obwohl es public/stil.css in diesem Beispiel gibt. Der
Pfad wird dabei einmal aufgelöst, beim Anlegen der Middleware, und nicht bei jeder Anfrage. Es zählt
also das Arbeitsverzeichnis beim Start.
join(import.meta.dirname, "public") ist der sichere Weg. import.meta.dirname ist das Verzeichnis
der Datei, in der es steht, und damit unabhängig davon, von wo aus jemand startet. Die Zeile steht
im Beispiel auskommentiert darunter. Nimmst du sie statt der anderen, steht im Reiter Browser das
Stylesheet, sobald die Seite nachgezogen hat.
Was im Ordner liegt, ist öffentlich
passwort=123 GEHEIM=123 import express from "express";
const app = express();
// Beide Dateien liegen in public, beide hat niemand verlinkt.
app.use(express.static("public"));
app.listen(3000); Es gibt kein Verzeichnis, das man kennen müsste, und keine Anmeldung. Wer den Dateinamen errät,
bekommt die Datei, ob sie verlinkt ist oder nicht. sicherung.bak hat niemand verlinkt und niemand
erwähnt. Trotzdem holt der Befehl aus der Befehlsleiste sie ins Terminal, samt Passwort.
Express tut damit, was express.static verspricht. Im Reiter Browser bleibt die Fläche leer, weil
Express die Datei als application/octet-stream schickt und ein Browser so etwas herunterladen
will, statt es zu zeigen.
.env liefert Express nicht aus. Auf /.env kommt eine 404, denn express.static überspringt von
sich aus Dateien, deren Name mit einem Punkt beginnt. Als Sicherheitsmaßnahme verlasse ich mich
darauf nicht, höchstens als letztes Netz. Gefährlich sind oft Dateien, die gar nicht .env heißen.
Sie heißen sicherung.bak, konfiguration.json, dump.sql oder notizen.txt, und die liefert
Express aus wie jedes Bild.
Der Server der Aufgabe liefert einen Ordner aus und soll trotzdem eine eigene Route behalten.
Zum Mitnehmen
express.static liefert einen ganzen Ordner aus, samt Inhaltstyp, Startseite und Kopfzeilen für den Zwischenspeicher, und den Ordner nennt man über import.meta.dirname. Jede Datei darin kann abrufen, wer ihren Namen kennt.
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.