Abschnitt 3 · Lektion 3
Verzeichnisse
Eine einzelne Datei zu lesen ist der einfache Fall. Meistens weißt du aber gar nicht, welche Dateien es gibt. Das musst du erst herausfinden.
Einen Ordner auflesen
Ein Ordner heißt in Node und in der Doku Verzeichnis (englisch directory), daher der Name readdir.
Die Funktion gibt dir die Namen der Einträge in einem Ordner.
Kaffee kaufen
Kurs bauen Notiz eins import { readdir } from "node:fs/promises";
// readdir garantiert keine Reihenfolge, deshalb wird hier sortiert.
const namen = (await readdir("inhalt")).sort();
console.log(namen);
console.log("Anzahl:", namen.length); In der Liste stehen nur Namen, also aufgaben.txt und nicht inhalt/aufgaben.txt. Der Ordner, den
du gerade abgefragt hast, taucht in den Ergebnissen nicht auf.
Eine Reihenfolge verspricht readdir nicht, in der Dokumentation steht dazu nichts. Unter Linux
kommen die Namen heute nach Bytes sortiert, und so würde kein Mensch sortieren. Zeitplan.txt steht
dann vor archiv, 10.txt vor 2.txt und äpfel.txt ganz hinten. Wer eine Reihenfolge braucht,
sortiert selbst. Das ist eine Zeile.
Die Falle mit dem Namen
Kaffee kaufen
Kurs bauen Notiz eins import { readdir, readFile } from "node:fs/promises";
const namen = (await readdir("inhalt")).sort();
console.log("Gefunden:", namen[1]);
// Gesucht wird im Arbeitsverzeichnis, nicht in inhalt/.
await readFile(namen[1], "utf8"); Der Name aus readdir ist relativ zu dem Ordner, den du aufgelesen hast. readFile löst ihn aber
gegen das Arbeitsverzeichnis auf, und dort liegt die Datei nicht. Heraus kommt ein ENOENT für eine
Datei, die du gerade selbst in der Liste gesehen hast. Im Terminal steht erst
Gefunden: notizen.txt und danach in Rot
Error: ENOENT: no such file or directory, open 'notizen.txt'. Im Pfad der Meldung fehlt das
inhalt/ davor.
Das kannst du im Terminal nachsehen, statt es zu glauben. ls zeigt, was im Arbeitsverzeichnis
liegt, nämlich index.mjs und den Ordner inhalt. ls inhalt zeigt, was darin liegt, nämlich die
beiden Textdateien. readFile sucht in der ersten Liste, gefunden hast du den Namen in der zweiten.
Die Lösung kennst du aus Lektion 2.4, nämlich path.join("inhalt", name). Dafür gibt es
node:path, und hier merkst du zum ersten Mal, warum.
Datei oder Ordner
readdir allein sagt dir nicht, was hinter einem Namen steckt. Dafür gibt es zwei Wege.
Der bequeme ist withFileTypes: true. Dann bekommst du statt bloßer Namen kleine Objekte, die ihren
Namen kennen und die Frage isDirectory() beantworten können.
Kaffee kaufen
Kurs bauen Alte Notiz import { readdir } from "node:fs/promises";
const eintraege = await readdir("inhalt", { withFileTypes: true });
eintraege.sort((a, b) => a.name.localeCompare(b.name));
for (const eintrag of eintraege) {
console.log(`${eintrag.name} (${eintrag.isDirectory() ? "Ordner" : "Datei"})`);
} In inhalt liegt neben der Textdatei ein Ordner archiv. In der Ausgabe steht archiv (Ordner)
über aufgaben.txt (Datei), die beiden sind also sauber auseinandergehalten.
Der allgemeine Weg ist stat(pfad). Es liefert deutlich mehr, nämlich Größe in Bytes, Zeitpunkt der
letzten Änderung und Rechte, dazu ebenfalls isDirectory() und isFile(). Dafür brauchst du aber
einen richtigen Pfad und einen Aufruf je Eintrag, und für die bloße Frage nach Datei oder Ordner ist
das mehr Aufwand als nötig.
Ordner anlegen
mkdir("berichte") legt einen Ordner an und scheitert, wenn es ihn schon gibt oder wenn der
übergeordnete Ordner fehlt.
Deshalb schreibe ich fast immer mkdir("berichte/2026", { recursive: true }). Das legt den ganzen
Weg an. Und der eigentliche Gewinn ist, dass es sich nicht beschwert, wenn schon alles da ist. Du
kannst es also bei jedem Start aufrufen, ohne vorher etwas zu prüfen.
Zwischen Frage und Zugriff
Es gibt zwar eine Funktion, die nachsieht, ob etwas existiert. Vor einem Zugriff benutze ich sie aber nicht.
Zwischen deiner Frage und deiner Handlung liegt ein Moment, und in diesem Moment kann sich die Welt ändern. Ein anderer Prozess löscht die Datei, ein Backup verschiebt sie, ein Nutzer räumt auf. Dein Code hat dann geprüft, dass alles in Ordnung ist, und stürzt eine Zeile später trotzdem ab.
In Node versucht man es deshalb gleich und fängt den Fehler ab. Das ist sicherer und auch kürzer. Wie das aussieht, steht in Lektion 3.5.
Im Reiter Praxis wartet ein Ordner, in dem Dateien und Ordner durcheinanderliegen.
Zum Mitnehmen
readdir liefert die Namen der Einträge ohne den Ordner davor und in keiner zugesagten Reihenfolge. Ob ein Eintrag ein Ordner ist, sagt withFileTypes, und mkdir mit recursive legt den ganzen Weg an, ohne sich über Vorhandenes zu beschweren.
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.