CKTIS / HTML
onrejectionhandled — spätere Behandlung einer Promise-Ablehnung
Das body-Attribut onrejectionhandled registriert einen Handler für das rejectionhandled-Ereignis von Window: Eine zuvor unbehandelte Promise-Ablehnung hat nachträglich einen Handler erhalten.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onrejectionhandled="handler(event)">
window.onrejectionhandled = handler;onrejectionhandled auf body ist ein Event-Handler-Attribut für Window und kein gewöhnliches elementlokales Ereignis. Die zugehörige Eigenschaft lautet window.onrejectionhandled.
Das Ereignis rejectionhandled tritt auf, wenn eine zuvor als unbehandelt gemeldete Ablehnung nachträglich behandelt wird. event.promise bezeichnet das Promise, und event.reason enthält den Ablehnungsgrund. Das Registrieren dieses Event-Handlers behandelt die Ablehnung nicht selbst; das Promise muss beispielsweise mit .catch() behandelt werden.
Das Beispiel wartet auf unhandledrejection und fügt dann in einem späteren Task .catch() hinzu. preventDefault() unterdrückt die standardmäßige Meldung des ersten Ereignisses, behandelt aber nicht das Promise. Auf der Seite sollte handled: demo angezeigt werden.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>rejectionhandled demo</title>
<body onrejectionhandled="if (event.promise === window.demoPromise) document.getElementById('result').textContent = 'handled: ' + event.reason">
<pre id="result">waiting</pre>
<script>
window.addEventListener('unhandledrejection', (event) => {
if (event.promise !== window.demoPromise) return;
event.preventDefault();
setTimeout(() => {
event.promise.catch(() => {});
}, 0);
});
window.demoPromise = Promise.reject('demo');
</script>
</body>Ergebnis
handled: 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.