Abschnitt 1 · Lektion 4
Fehler lesen in Node
Auf den ersten Blick sieht eine Node-Fehlermeldung aus wie eine Wand aus Text. Liest du sie von oben bis unten, bist du eine Weile beschäftigt. Dabei hat sie immer denselben Aufbau, und die Stelle, an der es klemmt, steht immer am selben Platz.
Immer derselbe Aufbau
const preise = [19, 29, 39];
console.log(summe(preise)); Von oben nach unten stehen dort vier Teile:
- Der Ort, also Dateiname, Doppelpunkt und Zeilennummer, darunter die Zeile selbst und ein Zeiger auf die Stelle. Liegt der Fehler im eigenen Code, ist das schon die Stelle.
- Die Art, etwa
ReferenceError,TypeError,SyntaxErroroderRangeError. Daran siehst du, welche Sorte Missverständnis vorliegt, noch bevor du den Text daneben gelesen hast. - Der Text, hier
summe is not defined, und der ist so wörtlich gemeint, wie er dasteht. - Der Stacktrace, die Zeilen mit
at. Er beschreibt den Weg dorthin. Ganz oben steht die Stelle, an der es geknallt hat, darunter die Aufrufe, die dorthin geführt haben.
Der Ort ist ein Button
Dateiname, Zeile und meistens noch die Spalte heißen zusammen die Fundstelle, im ersten Beispiel
also index.js:2:9. Sie steht unterstrichen da. Ein Klick darauf holt die Datei in den Editor,
springt auf die Zeile und färbt sie, bis du etwas änderst.
Das gilt für den Ort oben und für jede Zeile des Stacktrace, in der deine eigene Datei steht. Die
Zeilen aus node:internal bleiben einfacher Text. Dorthin führt kein Weg, und zu ändern gibt es
dort sowieso nichts. Im dritten Beispiel siehst du beides untereinander. Ganz oben steht
node:internal, und deine eigene Datei taucht erst in der neunten at-Zeile auf, als einzige mit
Unterstrich.
Wo deine eigene Datei steht
Liegt der Fehler in deinem eigenen Code, steht deine Datei schon ganz oben, im Ort und in der ersten
at-Zeile. Darunter folgen Einträge wie Module._compile und Module.load, und das ist Node
selbst. Anders sieht es aus, wenn Node selbst den Fehler wirft. Dann stehen oben Zeilen aus
node:internal, bei einem Paket Zeilen aus node_modules, und deine Datei kommt erst weiter unten,
wie im dritten Beispiel.
Es kommt also auf die oberste Zeile mit deinem eigenen Dateinamen an. Dort hat dein Code etwas getan, das nicht aufging. Alles darüber ist der Maschinenraum, alles darunter die Vorgeschichte. Diese Zeile hat auch als erste eine anklickbare Fundstelle, und du erkennst sie schon am Unterstrich.
Das gilt später auch für einen abgestürzten Server mit zwanzig Zeilen aus node_modules obendrauf.
Manche Fehler entstehen allerdings ganz in Node, etwa ein fetch ohne Netz. Dann steht deine Datei
nirgends im Stacktrace, und was los ist, erfährst du nur aus der Meldung.
Drei Fehler, die dir zuerst begegnen
Die ersten beiden gibt es im Browser genauso.
Ein ReferenceError heißt, dass es den Namen nicht gibt. Dahinter steckt ein Tippfehler, eine
vergessene Deklaration oder eine Funktion aus einer anderen Datei, die du noch nicht geholt hast.
Oder eben document in Node.
Ein TypeError heißt, dass es den Namen gibt, er aber nicht kann, was der Code von ihm will.
const kurs = { titel: "Node" };
console.log(kurs.titel.toUpperCase());
console.log(kurs.beschreibung.toUpperCase()); Die Meldung lautet TypeError: Cannot read properties of undefined (reading 'toUpperCase'), auf
Deutsch etwa „Von undefined lassen sich keine Eigenschaften lesen, gelesen werden sollte
toUpperCase“. kurs.beschreibung gibt es nicht, also ist der Wert undefined. Und an undefined
hängt kein toUpperCase.
Die Zeile vor dem Absturz schreibt noch ihr NODE heraus. Ein Absturz beendet das Programm an der
Stelle, an der er passiert, und nicht früher. Was schon ausgegeben wurde, bleibt also stehen, und
bei der Fehlersuche ist das oft der beste Hinweis darauf, wie weit das Programm überhaupt gekommen
ist.
Der dritte Fehler ist neu, im Browser gibt es ihn gar nicht.
const rechnen = require("./rechnen");
console.log(rechnen); Seine Art ist ein schlichtes Error, und im Text steht Cannot find module './rechnen'. Node hat
an den üblichen Stellen gesucht und nichts gefunden. Meist ist es ein falscher Pfad, ein vergessenes
./ oder ein Paket, das nicht installiert ist. Wo Node überall sucht, steht in Abschnitt 2, und
danach liest sich diese Meldung von selbst.
Der Exit-Code
Wenn ein Fehler unbehandelt bis nach oben durchschlägt, beendet Node den Prozess mit dem Exit-Code 1. Läuft alles durch, ist es 0. Diese eine Zahl unterscheidet „hat geklappt“ von „hat nicht geklappt“, und zwar für jedes Programm, das deins aufruft.
Daran erkennt eine Kommandozeile, ein Build-Skript oder ein Server, ob der Aufruf geklappt hat. Die Ausgabe ist ja nur Text für einen Menschen. In fast jeder Aufgabe mit einem Skript steht auch eine Prüfung auf den Exit-Code in der Prüfliste.
Im Terminal steht die Zahl nicht, wie in einer gewöhnlichen Shell auch. Du siehst dort, was dein
Programm geschrieben hat, und bei einem unbehandelten Fehler den Stacktrace in Rot. Ist die Prüfung
auf den Exit-Code rot, steht dort, was herauskam. Mit node index.js; echo $? steht die Zahl auch
im Terminal, in der Zeile nach der Ausgabe.
In der Aufgabe bringst du ein Skript mit zwei Fehlern dazu, bis zum Ende durchzulaufen.
Zum Mitnehmen
Eine Fehlermeldung nennt Ort, Art, Text und den Weg dorthin. Gesucht ist die erste Zeile mit deiner eigenen Datei, und ein unbehandelter Fehler endet mit Exit-Code 1.
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.