Abschnitt 7 · Lektion 3
Das error-Ereignis
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
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.
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.
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, 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.