mitmario.dev

Wenn der Zugriff scheitert

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

Dateizugriffe scheitern, und meistens aus Gründen, die mit deinem Code nichts zu tun haben. Die Datei ist noch nicht da. Jemand hat sie umbenannt. Die Platte ist voll. Ein Backup-Prozess hält sie gerade fest.

Ein Programm, das dabei jedes Mal umfällt, ist höchstens ein Prototyp.

Fehler haben einen Code

try und catch kennst du aus dem JavaScript-Kurs. Neu ist, was im Fehlerobjekt steht.

Ein Fehler mit Code
import { readFile } from "node:fs/promises";

try {
  await readFile("gibtesnicht.txt", "utf8");
} catch (fehler) {
  console.log("Code:", fehler.code);
  console.log("Meldung:", fehler.message);
  console.log("Pfad:", fehler.path);
}

Drei Eigenschaften sind interessant. code ist ein kurzer Fehlercode, message ein Satz für Menschen, und path sagt, um welche Datei es ging.

Ich prüfe immer auf code und nie auf message. Der Text ist Beiwerk und kann sich mit einer neuen Node-Version ändern. Außerdem steckt darin der Pfad, und der sieht auf jedem Rechner anders aus. Der Code dagegen ist eine Zusage. Wer fehler.message.includes("no such file") schreibt, baut eine Bedingung, die irgendwann still nicht mehr zutrifft.

ENOENT, EACCES und EISDIR

ENOENT heißt, an diesem Pfad ist nichts. Er ist der häufigste von allen und kommt beim Lesen, beim Schreiben in einen fehlenden Ordner und beim Umbenennen.

EACCES heißt, die Datei ist da, aber du darfst nicht ran. Auf dem eigenen Rechner siehst du ihn selten. Auf einem Server kommt er öfter vor, denn ein Dienst läuft dort unter einem eigenen Konto und nicht unter deinem.

EISDIR heißt, an dem Pfad liegt ein Ordner und keine Datei.

Ein Ordner ist keine Datei
import { readFile } from "node:fs/promises";

// daten ist ein Ordner, keine Datei.
try {
  await readFile("daten", "utf8");
} catch (fehler) {
  console.log("Code:", fehler.code);
  console.log("Meldung:", fehler.message);
}

Ein paar weitere lernst du mit der Zeit noch kennen. EEXIST beim Anlegen von etwas, das es schon gibt. ENOTEMPTY beim Löschen eines Ordners, in dem noch etwas liegt. ENOSPC, wenn die Platte voll ist. Alle folgen demselben Muster, ein E und eine Abkürzung.

Die Unterscheidung, auf die es ankommt

Manche Fehler kannst du erwarten. Beim allerersten Start fehlt die Konfigurationsdatei, das ist der Normalfall. Die richtige Reaktion darauf sind Standardwerte (englisch defaults).

Andere kannst du nicht erwarten. Die Rechte stimmen nicht, die Platte ist voll, der Pfad zeigt auf einen Ordner. Dann ist etwas grundsätzlich anders, als du angenommen hast. Das Programm sagt in dem Fall, was los ist, und hört auf.

Erwartet und unerwartet auseinanderhalten
import { readFile } from "node:fs/promises";

try {
  const roh = await readFile("einstellungen.json", "utf8");
  console.log("Geladen:", roh.length, "Zeichen");
} catch (fehler) {
  if (fehler.code === "ENOENT") {
    console.log("Noch keine Einstellungen, ich lege später welche an");
  } else {
    console.error("Damit habe ich nicht gerechnet:", fehler.code);
    process.exit(1);
  }
}

console.log("Weiter geht es");

Der erwartete Fall bekommt seinen eigenen Zweig, alles andere fällt in den else. Dort beendet process.exit(1) das Programm an Ort und Stelle mit Exit-Code 1, so wie es ein unbehandelter Fehler auch täte, nur mit deiner Meldung statt eines Stacktraces.

Ein catch-Block, der jeden Fehler schluckt und einfach weitermacht, sieht robust aus und ist das Gegenteil. Dein Programm läuft dann mit falschen Annahmen weiter, und der eigentliche Fehler taucht drei Schritte später an einer Stelle auf, die damit nichts zu tun hat.

Ich fange nur die Fehler ab, für die ich eine Antwort habe. In Abschnitt 16 bekommen die Fehler, auf die ein Programm eine Antwort haben kann, einen Namen und einen festen Platz in der Anwendung.

Versuchen statt vorher fragen

In Lektion 3.3 stand schon, dass man in Node nicht erst prüft, ob eine Datei existiert. Im dritten Beispiel steht, wie es stattdessen aussieht, und länger ist es nicht.

Der try-Block macht einen einzigen Versuch. Klappt er, ist alles gut. Klappt er nicht, verrät code den Grund, und zwar genauer, als es eine Vorab-Prüfung je gekonnt hätte.

Im Reiter Praxis braucht ein Programm Einstellungen, die es beim ersten Start noch nicht gibt.

Zum Mitnehmen

Ein Fehler beim Dateizugriff trägt in err.code einen Fehlercode wie ENOENT, EACCES oder EISDIR, und geprüft wird err.code, nicht err.message. Eine fehlende Datei beim ersten Start bekommt Standardwerte, alles andere beendet das Programm mit einer Meldung.

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.