mitmario.dev

Das error-Ereignis

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

Ereignisnamen sind frei wählbar, und Node kümmert sich nicht darum, wie du sie nennst. Bis auf einen.

error ist der einzige Name, bei dem es etwas auslöst, wenn niemand zuhört. Dann wirft Node den Fehler in den Prozess und beendet ihn.

Ein error mit und ohne Listener

Ein error ohne Listener
import { EventEmitter } from "node:events";

const melder = new EventEmitter();

console.log("vor emit");

melder.emit("error", new Error("etwas ist schiefgelaufen"));

console.log("nach emit");

Die Zeile nach dem emit wird nie erreicht. Im Terminal steht vor emit, und darunter in Rot der vollständige Stacktrace. Erst kommt die Codezeile, an der es passiert ist, dann der Satz mit der Fehlermeldung und die Aufrufkette. Darunter folgt ein zweiter Block mit der Überschrift Emitted 'error' event at:.

Auf diesen zweiten Block kommt es an. Er sagt, wo das Ereignis ausgelöst wurde, und nicht nur, wo der Fehler gebaut wurde. Hier ist beides dieselbe Zeile 7, nur die Spalte ist eine andere. In einem echten Programm liegen die zwei Stellen oft weit auseinander.

Drei Angaben darin sind Buttons, weil sie auf eine Datei zeigen, die du hier vor dir hast. Ein Klick darauf springt im Editor auf die Zeile. Was aus node:internal kommt, bleibt Text. Dort kannst du nichts ändern, und der Kurs schickt dich auch nicht hin.

Der Exit-Code ist 1, aber von selbst angezeigt wird er nirgends. Im Terminal lässt er sich mit node ohne-listener.js; echo $? sehen. Das ist derselbe Lauf, und die 1 steht direkt unter vor emit, weil das Terminal die Standardausgabe in einem Block zusammenhält. Das Semikolon gehört dazu, denn echo $? gibt den Code des Befehls davor aus. Als eigener Befehl abgeschickt, liefe es in einer frischen Shell, und dort steht in $? noch die Null vom Start.

Zum Vergleich derselbe Ablauf mit einem einzigen zusätzlichen Listener.

Derselbe Fehler mit Listener
import { EventEmitter } from "node:events";

const melder = new EventEmitter();

melder.on("error", (fehler) => console.log(`abgefangen: ${fehler.message}`));

console.log("vor emit");

melder.emit("error", new Error("etwas ist schiefgelaufen"));

console.log("nach emit");

Ein on("error", ...), und aus dem Abbruch wird ein ganz normaler Programmablauf. Der Prozess läuft weiter, nach emit kommt dran, und der Exit-Code ist 0.

Bleibt die Frage, ob wirklich der Name die Sonderregel trägt oder doch das Error-Objekt darin.

Jeder andere Name bleibt folgenlos
import { EventEmitter } from "node:events";

const melder = new EventEmitter();

melder.emit("warnung", new Error("kein Listener, keine Sonderregel"));

console.log("läuft einfach weiter");

Derselbe Fehler unter einem anderen Ereignisnamen, und es passiert schlicht nichts. Nicht mal ein Hinweis. Ein Ereignis ohne Listener ist normalerweise völlig in Ordnung.

Warum Node so hart reagiert

Auf den ersten Blick wirkt das übertrieben. Ein Programm zu beenden, nur weil ein Ereignis nicht abgeholt wurde, klingt nach Schikane.

Die Alternative ist aber schlechter. Ein error, den niemand abholt, heißt, dass etwas schiefgegangen ist und keine Stelle im Programm davon weiß. Ohne die Sonderregel würde dein Programm einfach weiterlaufen, und zwar in einem Zustand, mit dem niemand gerechnet hat. Ein Datenbankschreiber ohne Verbindung, ein Stream ohne Datei, ein Server ohne Port.

Node ist ein lauter Abbruch lieber als ein stiller Fehlzustand. Beim Callback-Stil aus Lektion 6.3 ist es andersherum. Dort bleibt ein Fehler still, wenn niemand nach ihm fragt. Beim error-Ereignis lässt Node das nicht zu.

Wo dir das begegnet

Dafür brauchst du keinen eigenen Emitter. Alles, was in Node melden kann, meldet auch Fehler auf diesem Weg.

Ein Stream meldet error, wenn die Datei verschwindet oder die Platte voll ist. Ein Server meldet error, wenn der Port belegt ist. Ein Socket meldet error, wenn die Verbindung abreißt. Ein Kindprozess meldet error, wenn sich das Programm gar nicht erst starten ließ.

Ich hänge an jeden Emitter, der Fehler melden kann, ein on("error", ...), und zwar bevor er losläuft. Nachträglich anmelden hilft nicht, denn zu dem Zeitpunkt ist der Prozess schon weg.

Ein try/catch hilft dir dabei meistens nicht

emit ruft seine Listener synchron auf. Ein emit im eigenen Code lässt sich deshalb tatsächlich mit try und catch umschließen.

Nur passiert der Fehler in echtem Code fast nie an dieser Stelle. Ein Stream meldet ihn nicht, während du createReadStream aufrufst, sondern erst danach aus der Event Loop heraus. Bei einer fehlenden Datei ist das rund eine Millisekunde später, und dein try ist da längst durchgelaufen. catch sieht nichts.

Für einen einzelnen Emitter heißt das Mittel on("error", ...). Für eine ganze Kette von Streams nimmt dir pipeline diese Arbeit zwei Lektionen weiter ab, und aus dem Fehler wird dort ein abgelehntes Promise, auf das du mit await warten kannst. In Lektion 16.4 kommt derselbe Mechanismus noch einmal für Promises, die niemand abfängt. Auch dort beendet Node lieber den Prozess.

In der Aufgabe bricht ein Verarbeiter an seiner ersten .tmp-Datei ab, und du lässt ihn durchlaufen.

Zum Mitnehmen

Ein error-Ereignis ohne Listener wirft den Fehler und beendet den Prozess mit Exit-Code 1, jeder andere Name verpufft still. Ein Listener auf error, angehängt bevor der Emitter losläuft, macht daraus einen normalen Ablauf.

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.