CKTIS / JavaScript
unhandledrejection — nicht behandelte Promise-Ablehnung
Das Ereignis unhandledrejection meldet eine Promise-Ablehnung, die zum Zeitpunkt der Meldung durch den Browser noch nicht behandelt wurde. Es stellt das Promise und den Ablehnungsgrund bereit und dient der Diagnose, nicht als Ersatz für eine lokale Fehlerbehandlung.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.addEventListener("unhandledrejection", (event) => { /* event.promise, event.reason */ });unhandledrejection ist ein Ereignis der Webplattform, das als PromiseRejectionEvent an ein globales Objekt wie window gesendet wird. Es ist keine ECMAScript-Syntax. event.promise bezeichnet das abgelehnte Promise, und event.reason enthält den Ablehnungsgrund — einen beliebigen Wert, nicht unbedingt ein Error-Objekt.
Die Benachrichtigung erfolgt asynchron: Der Browser berücksichtigt Handler, die während der Verarbeitung von Mikroaufgaben hinzugefügt werden, und prüft den Behandlungsstatus vor dem Senden des Ereignisses erneut. Daher garantiert Promise.reject() allein kein Ereignis. Ein rechtzeitig hinzugefügtes .catch() kann es verhindern; ein Handler, der erst nach der Meldung hinzugefügt wird, kann ein separates rejectionhandled-Ereignis auslösen.
Das Ereignis ist abbrechbar. event.preventDefault() unterdrückt die standardmäßige Konsolenmeldung für diese Ablehnung, ändert aber weder den Zustand des Promises noch ersetzt es .catch() oder try/catch um await. Setze es bewusst ein, damit Fehler nicht verborgen bleiben. Dieser Mechanismus ist kein vollständiges Fehlerprotokoll: Für Skripte mit dem Flag muted errors wird das Tracking übersprungen, darunter auch in einigen Fällen mit Cross-Origin-Skripten.
Das Beispiel filtert Ereignisse anhand der Promise-Identität, gibt den Grund aus und entfernt den Listener. Führe es als Skript auf einer leeren Browserseite aus, nicht in Node.js. Die API ist im HTML Living Standard spezifiziert; eine ECMAScript-Version oder das Vorhandensein von Node 24 belegt keine Browserunterstützung.
Beispiele
(() => {
let rejected;
function report(event) {
if (event.promise !== rejected) return;
event.preventDefault();
window.removeEventListener("unhandledrejection", report);
console.log("unhandled:", event.reason);
}
window.addEventListener("unhandledrejection", report);
rejected = Promise.reject("demo");
})();Ergebnis
unhandled: demo
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.