WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen