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.