Abschnitt 3 · Lektion 1
Dateien lesen
Eine Einkaufsliste, die im Code steht, ändert nur, wer den Code ändert. Liegt sie in einer Datei, reicht ein Editor, und das Programm liest beim nächsten Start die neue Fassung. Dafür muss es an die Festplatte, und dorthin kommt der Browser nie. Node schon.
Zwei Arten, dasselbe Modul zu benutzen
node:fs gibt es in zwei Ausführungen. Die ältere arbeitet mit Callbacks, die neuere mit Promises
und heißt node:fs/promises. Dahinter steckt dasselbe Modul mit denselben Möglichkeiten, nur die
Schreibweise ist eine andere.
Ich nehme in diesem Kurs node:fs/promises, weil du await schon kennst und weil verschachtelte
Callbacks ab drei Dateien unlesbar werden. In altem Code wirst du die Callback-Variante trotzdem
sehen.
Daneben gibt es in node:fs zu jeder Funktion noch eine Variante mit Sync am Ende, also
readFileSync statt readFile. Die wartet, bis die Datei da ist, und blockiert dabei alles andere.
Warum das ein Problem ist, steht in Abschnitt 6, und dort kommt auch die eine Ausnahme dazu. Was nur
einmal beim Start gelesen wird, darf synchron sein.
Kaffee
Tee
Kakao import { readFile } from "node:fs/promises";
const text = await readFile("liste.txt", "utf8");
console.log(text);
console.log("Zeichen:", text.length);
console.log("Zeilen:", text.trim().split("\n").length); Dateiname rein, Inhalt raus, mehr ist es nicht. Der Pfad wird relativ zum Arbeitsverzeichnis aufgelöst, nicht relativ zu deiner Datei. Das ist der Unterschied aus Lektion 2.4, und hier trifft er dich zum ersten Mal wirklich.
Der zweite Parameter, den man einmal vergisst
"utf8" ist die Kodierung (englisch encoding) und sagt Node, wie es die Bytes in der Datei als
Text deuten soll. Lässt du es weg, deutet Node gar nichts und gibt dir die Bytes selbst.
Kaffee
Tee
Kakao import { readFile } from "node:fs/promises";
// Der zweite Parameter fehlt, deshalb kommen rohe Bytes zurück.
const roh = await readFile("liste.txt");
console.log("Roh:", roh);
console.log("Typ:", roh.constructor.name);
console.log("Als Text:", roh.toString("utf8").trim()); Ein Buffer ist eine Liste von Bytes, ausgegeben in Hexadezimalschreibweise. Ein paar davon lassen
sich sogar lesen. 4b ist das K von Kaffee, und 0a ist der Zeilenumbruch.
Verwirrend ist, dass sich ein Buffer oft wie Text benimmt. Hängst du ihn an einen Text, wandelt
JavaScript ihn stillschweigend um. Ein .trim() darauf endet dagegen mit
TypeError: roh.trim is not a function, zu Deutsch „roh.trim ist keine Funktion“. Ein Buffer hat
diese Methode nicht. Und der Fehler steht in einer ganz anderen Zeile als die vergessene Angabe.
Für alles, was kein Text ist, also Bilder, PDFs oder Videos, ist ein Buffer der richtige Datentyp. In Abschnitt 7 taucht er wieder auf, wenn eine Datei stückweise gelesen wird.
Was du mit dem Text danach machst
Eine Textdatei kommt als ein einziger langer Text zurück, mit Zeilenumbrüchen darin. Als Erstes wird er deshalb meistens zerlegt.
Kaffee;2000
Tee;1000
Kakao;500 import { readFile } from "node:fs/promises";
const text = await readFile("preise.txt", "utf8");
const zeilen = text.trim().split("\n");
for (const zeile of zeilen) {
const [name, cent] = zeile.split(";");
console.log(`${name}: ${(Number(cent) / 100).toFixed(2).replace(".", ",")} EUR`);
} Vor dem split() steht ein trim(). Fast jede Textdatei endet mit einem Zeilenumbruch, und ohne
trim() hättest du am Ende eine leere Zeile dabei, mit der du beim Zählen nicht rechnest. Solche
Kleinigkeiten können einen ganzen Nachmittag kosten.
Wenn die Datei zu groß wird
readFile holt die ganze Datei in den Arbeitsspeicher, bevor du die erste Zeile siehst. Bei einer
Liste mit dreißig Einträgen ist das völlig egal.
Bei einer Protokolldatei (englisch log file) mit zwei Gigabyte ist es das nicht. Als Text geht sie
gar nicht erst, denn ein Text darf in Node höchstens rund eine halbe Milliarde Zeichen lang werden.
Ab 2 GiB weigert sich readFile ganz. Das Programm bricht dann ab, ohne eine einzige Zeile
verarbeitet zu haben.
Für diesen Fall gibt es Streams. Damit läuft eine Datei Stück für Stück durch, ohne dass sie je ganz
im Speicher liegt. Gebaut wird das in Abschnitt 7. Bis dahin nehme ich readFile nur für Dateien,
deren Größe ich kenne und die in den Speicher passen.
In der Aufgabe liegen zwei Textdateien, und dein Programm zählt ihre Zeilen.
Zum Mitnehmen
readFile aus node:fs/promises holt eine Datei ganz in den Speicher, und mit utf8 als zweitem Parameter kommt Text heraus. Fehlt die Kodierung, kommt ein Buffer mit den rohen Bytes, und an dem scheitert schon ein trim.
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.