mitmario.dev

Verzeichnisse

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

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.

Einen Ordner auflesen
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

Ein Name ist noch kein Pfad
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.

Datei oder Ordner
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, 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.