mitmario.dev

Synthese: die Notizverwaltung

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

Ein paar Notizen speichern klingt nach einer Kleinigkeit. Trotzdem braucht ein Werkzeug dafür alles aus diesem Abschnitt auf einmal. Es liest eine Datei, die es beim ersten Start noch nicht gibt, und schreibt in einen Ordner, der vielleicht fehlt. Dabei darf es keine Notiz verlieren, auch dann nicht, wenn die Datei kaputt ist.

Der Ablauf in vier Schritten

Zuerst legt das Programm vor dem Schreiben den Ordner an, mit mkdir und recursive: true, und zwar ohne jede Bedingung.

mkdir stört sich nicht daran
import { mkdir, readdir } from "node:fs/promises";

await mkdir("daten/2026", { recursive: true });
await mkdir("daten/2026", { recursive: true });

console.log("Zweimal aufgerufen, kein Fehler.");
console.log("Vorhanden:", await readdir("daten"));

Der Aufruf beschwert sich nicht, wenn schon alles da ist, und deshalb setze ich die Option praktisch immer. Eine Prüfung davor und ein try darum brauchst du dann nicht. Scheitern kann mkdir jetzt nur noch an etwas Grundsätzlichem. Das ist eine Datei dort, wo ein Ordner hinsoll (EEXIST oder ENOTDIR), oder es fehlen die Rechte (EACCES).

Danach wird geladen, oder das Programm fängt mit einem Standardwert an. Beim ersten Start gibt es die Datei nicht, und das ist kein Fehler.

Laden oder frisch anfangen
import { readFile } from "node:fs/promises";

async function laden(pfad) {
  try {
    return JSON.parse(await readFile(pfad, "utf8"));
  } catch (fehler) {
    if (fehler.code === "ENOENT") return [];
    throw fehler;
  }
}

const notizen = await laden("daten/notizen.json");

console.log("Geladen:", notizen.length, "Notizen");
console.log("Fängt also frisch an:", notizen.length === 0);

Abgefangen wird hier nur ENOENT, jeder andere Fehler fliegt weiter. Eine kaputte JSON-Datei oder fehlende Rechte sollen dein Programm anhalten. Eine leere Liste darf daraus nicht werden. Sonst überschreibst du im nächsten Schritt eine Datei voller Daten mit einem leeren Array, und niemand merkt es.

Dann wird geändert, und ab hier ist es ganz normales JavaScript mit push, find und filter. Die Daten liegen als Objekt im Speicher und wissen nichts mehr von einer Datei.

Zum Schluss geht die ganze Liste zurück in die Datei, mit JSON.stringify und writeFile in einem Zug.

Warum das Muster funktioniert

Im Speicher gibt es keinen Zwischenzustand. Die Liste ist geladen oder geschrieben, und du musst dir nie merken, welche Änderung schon gespeichert ist. Die Datei selbst ist während writeFile allerdings kurz leer oder halb geschrieben, und wer sie in diesem Moment liest, bekommt kaputtes JSON. Wer da sicher sein will, schreibt erst in eine zweite Datei und benennt sie dann um, wie in Lektion 3.2.

Für ein Kommandozeilenwerkzeug passt das. Es läuft, macht eine Sache, schreibt einmal und ist fertig.

Wenn zwei gleichzeitig schreiben

Wo das Muster aufhört zu tragen
import { mkdir, readFile, writeFile } from "node:fs/promises";

const PFAD = "daten/liste.json";

async function hinzufuegen(text) {
  let liste = [];
  try {
    liste = JSON.parse(await readFile(PFAD, "utf8"));
  } catch (fehler) {
    if (fehler.code !== "ENOENT") throw fehler;
  }
  // Zwischen Lesen und Schreiben passiert in echtem Code die eigentliche Arbeit.
  await new Promise((weiter) => setTimeout(weiter, 50));
  liste.push(text);
  await writeFile(PFAD, JSON.stringify(liste));
}

await mkdir("daten", { recursive: true });

await writeFile(PFAD, "[]");
await hinzufuegen("Brot kaufen");
await hinzufuegen("Auto putzen");
console.log("Nacheinander gespeichert:", JSON.parse(await readFile(PFAD, "utf8")).length);

await writeFile(PFAD, "[]");
await Promise.all([hinzufuegen("Brot kaufen"), hinzufuegen("Auto putzen")]);
console.log("Gleichzeitig gespeichert:", JSON.parse(await readFile(PFAD, "utf8")).length);

„Brot kaufen“ und „Auto putzen“ kommen zweimal auf die Liste, einmal nacheinander und einmal gleichzeitig. In hinzufuegen liegt zwischen Lesen und Schreiben eine kurze Pause, dort, wo ein echtes Programm seine Arbeit tut. Nacheinander landen beide Einträge in der Datei. Gleichzeitig landet nur einer.

Beide Abläufe lesen dieselbe leere Liste, beide hängen ihren Eintrag an ihre eigene Kopie an, beide schreiben die ganze Datei. Der zweite Schreiber überschreibt den ersten samt seinem Eintrag. Im Beispiel gibt es dabei keinen Fehler und keine Meldung. Es fehlt einfach ein Eintrag. Sind die beiden Texte verschieden lang, kann sogar ein Rest des längeren hinten stehen bleiben, und danach ist die ganze Datei kein gültiges JSON mehr.

Hier erzwingt Promise.all den Fall. Im Betrieb passiert er von allein, aus zwei Terminals oder auf einem Webserver mit vielen Anfragen.

Wer erst ganz liest und dann ganz schreibt, hat dieses Loch in jedem Format, mit JSON und Node genauso wie anderswo. Die Lösung heißt Datenbank. Sie kann einen einzelnen Eintrag ändern, ohne die anderen anzufassen, und sie regelt, wer wann darf. Mit ihr fängt Abschnitt 12 an, und dort taucht dieser Wettlauf wieder auf.

In der Aufgabe setzt du die vier Schritte zu einer Notizverwaltung zusammen.

Zum Mitnehmen

Ordner sicherstellen, laden oder mit einer leeren Liste anfangen, ändern und ganz zurückschreiben, so arbeitet ein Werkzeug mit einer JSON-Datei. Schreiben zwei Abläufe gleichzeitig, gewinnt der letzte, und der Eintrag des anderen fehlt.

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.