CKTIS / HTML
onunhandledrejection — nicht behandelte Promise-Ablehnung
Das Attribut onunhandledrejection auf body registriert einen Handler für das unhandledrejection-Ereignis des Window-Objekts. Es macht den Ablehnungsgrund eines Promise zugänglich, für das zum Zeitpunkt der Benachrichtigung noch kein Ablehnungs-Handler vorhanden ist.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onunhandledrejection="/* JavaScript using event */">onunhandledrejection ist ein Event-Handler-Attribut, dessen Wert JavaScript-Code ist. Auf body legt es den Handler für das unhandledrejection-Ereignis des Window-Objekts fest, nicht für ein separates Elementereignis. Es ist kein gewöhnliches globales HTML-Attribut, das auf jedem Element verfügbar ist. Das JavaScript-Gegenstück ist die Eigenschaft window.onunhandledrejection.
Die Benachrichtigung erfolgt asynchron. Wird früh genug ein Handler für Ablehnungen hinzugefügt, tritt das Ereignis nicht auf. Das event-Objekt ist ein PromiseRejectionEvent: event.promise bezeichnet das abgelehnte Promise und event.reason enthält den Ablehnungsgrund.
Der Aufruf von event.preventDefault() unterdrückt die standardmäßige Konsolenmeldung für dieses Ereignis; er behebt das Promise nicht. Behandle erwartete Fehler an ihrer Quelle, statt dich ausschließlich auf eine globale Benachrichtigung zu verlassen.
Das Beispiel setzt das Attribut auf body und behandelt die Promise-Ablehnung mit promise.catch(() => {}). Der Aufruf von window.dispatchEvent() löst auf window ein synthetisches, abbrechbares unhandledrejection-Ereignis aus. Dadurch wird der Handler aufgerufen, der event.reason in der Konsole ausgibt. Das Beispiel zeigt, dass der Handler korrekt eingebunden ist, nicht wie der Browser über eine unbehandelte Ablehnung benachrichtigt. event.preventDefault() bezieht sich hier nur auf das synthetische Ereignis und demonstriert nicht, wie die Standardmeldung des Browsers zu einer unbehandelten Ablehnung unterdrückt wird. Inline-Code benötigt die Erlaubnis gemäß der Sicherheitsrichtlinie der Seite.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Body onunhandledrejection handler</title>
</head>
<body onunhandledrejection="event.preventDefault(); console.log('reason: ' + event.reason)">
<script>
const reason = 'demo';
const promise = Promise.reject(reason);
// Handle the fixture so the browser does not report a real unhandled rejection.
promise.catch(() => {});
window.dispatchEvent(new PromiseRejectionEvent('unhandledrejection', {
promise,
reason,
cancelable: true
}));
</script>
</body>
</html>Ergebnis
reason: 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.