Abschnitt 3 · Lektion 5
Wenn der Zugriff scheitert
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.
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.
eins 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.
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, 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.