Abschnitt 3 · Lektion 2
Dateien schreiben
Lesen kann nichts kaputt machen. Sobald ein Programm schreibt, bleibt nach dem Ende etwas zurück. Und ein falscher Pfad reicht, um eine Datei zu ersetzen, die noch gebraucht wurde.
Zwei Funktionen, ein Unterschied
writeFile legt eine Datei an. Gibt es sie schon, ersetzt es ihren Inhalt. appendFile hängt an
das an, was schon da ist, und legt die Datei an, falls es sie noch nicht gibt.
import { appendFile, readFile } from "node:fs/promises";
// Gibt es protokoll.txt noch nicht, legt appendFile sie an.
await appendFile("protokoll.txt", "Lauf gestartet\n");
console.log(await readFile("protokoll.txt", "utf8")); Das \n am Ende des Textes ist Absicht. Node schreibt Zeichen für Zeichen, was du übergibst, und
hängt von sich aus keinen Zeilenumbruch an. Ohne das \n stünde nach drei Läufen
Lauf gestartetLauf gestartetLauf gestartet in einer einzigen Zeile.
Nachsehen, statt zu glauben
Bis hierhin musstest du jeder Ausgabe glauben, etwas anderes ging nicht. Ab jetzt kannst du nachsehen, und zwar im Terminal. Es läuft auf derselben Maschine und im selben Verzeichnis wie dein Programm, und du siehst dort genau den Stand, den der letzte Lauf hinterlassen hat.
Nach „Sandbox starten“ läuft das erste Beispiel einmal. Ein ls im Terminal zeigt danach neben
index.mjs auch protokoll.txt. cat protokoll.txt gibt die eine Zeile zurück, und nach jedem
node index.mjs steht dort eine mehr. Der Unterschied zum console.log im Beispiel ist klein und
trotzdem entscheidend. Dort sagt dir dein eigenes Programm, was es gelesen zu haben glaubt. Hier
siehst du die Datei selbst.
Der Prüfen-Button räumt das Verzeichnis vorher auf, das Terminal nicht. Was du dort siehst, ist also der Stand nach dem letzten Lauf. Nach einem Klick auf Prüfen fängt alles wieder mit den Dateien aus dem Editor an.
Es gibt keine Rückfrage
Das ist der Punkt, den ich am Anfang meiner Laufbahn einmal auf die harte Tour gelernt habe.
import { writeFile, readFile } from "node:fs/promises";
await writeFile("notiz.txt", "Der wichtige Text von gestern\n");
console.log("Vorher:", (await readFile("notiz.txt", "utf8")).trim());
await writeFile("notiz.txt", "Neu\n");
console.log("Nachher:", (await readFile("notiz.txt", "utf8")).trim()); Der alte Inhalt ist weg. Er liegt nicht im Papierkorb und nicht in einer .bak-Datei, er ist weg.
Es gibt keine Warnung, keinen Rückgabewert, der dich darauf hinweist, und keinen Weg zurück.
writeFile tut damit nur, was sein Name sagt. Ich schaue deshalb vorher nach, welche Datei an dem
Pfad liegt, vor allem dann, wenn der Pfad aus einer Variablen kommt und nicht direkt im Code steht.
Wer wirklich nur anlegen und niemals überschreiben will, kann writeFile mit { flag: "wx" }
aufrufen. Dann scheitert der Aufruf, wenn die Datei schon existiert, statt sie zu ersetzen.
Ordner legt Node nicht nebenbei an
import { writeFile } from "node:fs/promises";
// Den Ordner berichte gibt es nicht, und Node legt ihn nicht nebenbei an.
await writeFile("berichte/juli.txt", "Inhalt\n"); Du legst eine Datei an, und Node beschwert sich, dass etwas nicht existiert. Im Terminal steht
Error: ENOENT: no such file or directory, open 'berichte/juli.txt', also keine solche Datei und
kein solcher Ordner. Gemeint ist der Ordner darüber und nicht deine Datei. writeFile legt nur eine
Sache an, nämlich die Datei. Der Weg dorthin muss schon da sein.
ENOENT wirst du in Node ständig sehen. Der Code steht für „error: no entry“ und heißt immer, dass
an diesem Pfad nichts ist. Wie du Ordner anlegst, kommt in der nächsten Lektion. Und wie du solche
Fehler abfängst, statt daran abzustürzen, steht in Lektion 3.5.
Umbenennen und löschen
Zwei weitere Funktionen aus node:fs/promises gehören noch dazu.
rename(alt, neu) benennt um und verschiebt zugleich, denn ein neuer Pfad ist ein neuer Ort. So
speichert man auch sicher. Erst kommt der neue Inhalt in eine temporäre Datei, dann benennt rename
sie auf den richtigen Namen um. Bricht das Programm mittendrin ab, ist die alte Datei noch
vollständig da statt halb überschrieben.
rm(pfad) löscht, mit { recursive: true } auch einen Ordner samt allem, was darin liegt.
Nachgefragt wird dabei genauso wenig wie bei writeFile.
In der Aufgabe wird bericht.txt angelegt und danach zweimal ergänzt.
Zum Mitnehmen
writeFile ersetzt einen vorhandenen Inhalt ohne Nachfrage, appendFile hängt an, und einen fehlenden Ordner legt keins von beiden an.
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.