mitmario.dev

Fehler lesen in Node

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

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

Der Aufbau einer Fehlermeldung
const preise = [19, 29, 39];
console.log(summe(preise));

Von oben nach unten stehen dort vier Teile:

  1. 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.
  2. Die Art, etwa ReferenceError, TypeError, SyntaxError oder RangeError. Daran siehst du, welche Sorte Missverständnis vorliegt, noch bevor du den Text daneben gelesen hast.
  3. Der Text, hier summe is not defined, und der ist so wörtlich gemeint, wie er dasteht.
  4. 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.

Ein TypeError sagt, was das Ding nicht kann
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.

Den Modulfehler gibt es im Browser 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, 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.