Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onrejectionhandled — późniejsza obsługa odrzucenia Promise

Atrybut onrejectionhandled elementu body rejestruje obsługę zdarzenia rejectionhandled obiektu Window: wcześniej nieobsłużone odrzucenie Promise otrzymało później obsługę.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<body onrejectionhandled="handler(event)">
window.onrejectionhandled = handler;

onrejectionhandled na elemencie body jest atrybutem obsługi zdarzenia obiektu Window, a nie zwykłym zdarzeniem lokalnym elementu. Odpowiada mu właściwość window.onrejectionhandled.

Zdarzenie rejectionhandled następuje, gdy wcześniej zgłoszone nieobsłużone odrzucenie otrzyma obsługę. event.promise wskazuje obietnicę, a event.reason zawiera powód odrzucenia. Samo zarejestrowanie tego zdarzenia nie obsługuje odrzucenia; potrzebna jest np. metoda .catch() na obietnicy.

Przykład czeka na unhandledrejection, a następnie dołącza .catch() w późniejszym zadaniu. preventDefault() wycisza domyślne raportowanie pierwszego zdarzenia, ale nie obsługuje obietnicy. Wynikiem widocznym na stronie powinno być handled: demo.

Przykłady

<!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>

Wynik

handled: demo

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła