Abschnitt 2 · Lektion 4
Pfade mit path
Ein Pfad ist am Ende nur ein Text, also ist die Versuchung groß, ihn selbst zusammenzusetzen.
ordner + "/" + datei sieht harmlos aus und funktioniert auf dem eigenen Rechner auch. Das Problem
kommt später, und zwar an einer Stelle, an der du es nicht mehr mit dieser Zeile in Verbindung
bringst.
Was beim Aneinanderkleben schiefgeht
import path from "node:path";
const ordner = "daten/";
const datei = "/liste.json";
console.log("Selbst gebaut:", ordner + datei);
console.log("Mit join:", path.join(ordner, datei));
console.log("Eine Ebene hoch:", path.join("daten", "..", "bilder", "logo.png")); Im Beispiel endet der Ordner auf einen Schrägstrich und die Datei fängt mit einem an. Zusammengeklebt ergibt das zwei Schrägstriche mitten im Pfad. Unter Linux geht das oft noch gut. In einer Fehlermeldung sieht es aber seltsam aus, und beim Vergleich zweier Pfade sind es plötzlich zwei verschiedene Texte.
path.join räumt das auf. Es setzt genau einen Trenner zwischen die Teile, wirft doppelte weg und
löst .. gleich mit auf.
Dazu kommt der Grund, aus dem es node:path überhaupt gibt. Windows trennt Pfade mit einem
Backslash, Linux und macOS mit einem Schrägstrich. Wer den Trenner selbst tippt, legt sich damit
auf ein Betriebssystem fest. Mit path.join entscheidet Node, und zwar auf dem Rechner, auf dem das
Programm gerade läuft. Und ein Server ist fast immer ein anderer Rechner als der, an dem du
arbeitest.
Einen Pfad wieder auseinandernehmen
Oft brauchst du es andersherum, also aus einem vollständigen Pfad nur einen Teil.
import path from "node:path";
const pfad = "/vercel/sandbox/lern/daten/liste.json";
console.log("Datei:", path.basename(pfad));
console.log("Name:", path.basename(pfad, ".json"));
console.log("Endung:", path.extname(pfad)); basename gibt die Datei, extname die Endung, dirname den Ordner davor. Bekommt basename die
Endung als zweites Argument, schneidet es sie ab. Das ist praktisch, wenn du aus liste.json nur
den Namen liste brauchst.
Auch das ließe sich mit split("/") und slice nachbauen. Die eingebaute Fassung kennt aber die
Sonderfälle, an die man in dem Moment nicht denkt, und sie liest sich in einem halben Jahr noch von
selbst.
Der Unterschied, an dem Programme umfallen
Es gibt zwei Orte, und sie sehen sich zum Verwechseln ähnlich.
process.cwd() ist das Arbeitsverzeichnis (englisch current working directory, daher der Name),
also der Ordner, in dem jemand stand, als er den Befehl abgeschickt hat. Mit dem Ort deiner Datei
hat er nichts zu tun.
import.meta.dirname ist dagegen der Ordner deiner Datei. Den Namen gibt es seit Node 20.11, und
seit Node 24 gilt er nicht mehr als experimentell. In älteren Anleitungen wird derselbe Wert noch
mit path.dirname(fileURLToPath(import.meta.url)) zusammengebaut.
In CommonJS heißt derselbe Wert __dirname. In einer .mjs gibt es diesen Namen nicht, und wer ihn
aus einer alten Anleitung mitnimmt, bekommt
ReferenceError: __dirname is not defined in ES module scope.
Startest du dein Programm aus seinem eigenen Ordner, sind process.cwd() und import.meta.dirname
gleich. Auf dem eigenen Rechner fällt der Unterschied deshalb monatelang nicht auf.
["Kaffee", "Tee", "Kakao"] import path from "node:path";
import { readFileSync } from "node:fs";
console.log("Arbeitsverzeichnis:", process.cwd());
console.log("Verzeichnis der Datei:", import.meta.dirname);
const richtig = path.join(import.meta.dirname, "daten", "liste.json");
const falsch = path.join(process.cwd(), "daten", "liste.json");
console.log("Richtig:", readFileSync(richtig, "utf8").trim());
console.log("Falsch:", readFileSync(falsch, "utf8")); Hier liegt die Datei in app/, gestartet wurde aber eine Ebene darüber mit node app/index.mjs.
Und schon zeigen die beiden ersten Zeilen auf verschiedene Orte. Die Variante mit process.cwd()
sucht die Daten im Arbeitsverzeichnis, findet dort nichts und meldet ENOENT, obwohl die Datei
existiert.
So entsteht der Klassiker, bei dem auf deinem Rechner alles läuft und auf dem Server nicht. Dort startet ein Dienst dein Programm, und der steht in irgendeinem Verzeichnis, das mit deinem Projekt nichts zu tun hat.
Welcher Ort für welche Datei
Für Dateien, die zum Programm gehören, ist import.meta.dirname der Ausgangspunkt. Vorlagen,
Konfigurationsdateien und mitgelieferte Daten liegen neben dem Code und wandern mit ihm mit.
Gibt der Nutzer den Pfad an, ist process.cwd() richtig. Wer ein Kommandozeilenwerkzeug mit
werkzeug bericht.txt aufruft, meint die Datei in seinem aktuellen Ordner und nicht eine neben dem
Werkzeug. In Abschnitt 4 entsteht so ein Werkzeug.
Für den Rest gibt es noch path.resolve. Es macht aus allem, was du hineingibst, einen absoluten
Pfad, und zwar ausgehend vom Arbeitsverzeichnis.
In der Aufgabe startet ein fremdes Programm deine Datei aus einem ganz anderen Ordner, und sie soll ihre Vorlage trotzdem finden.
Zum Mitnehmen
path.join setzt Pfade mit dem Trenner des Systems zusammen. Für Dateien, die zum Programm gehören, zählt der Ordner der Datei, import.meta.dirname, und nicht process.cwd(), der Ort, an dem gestartet wurde.
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.