CKTIS / HTML
onunhandledrejection — nieobsłużone odrzucenie obietnicy
Atrybut onunhandledrejection na elemencie body rejestruje obsługę zdarzenia unhandledrejection obiektu Window. Pozwala odczytać powód odrzucenia obietnicy, która nadal nie ma obsługi odrzucenia w chwili powiadomienia.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onunhandledrejection="/* JavaScript using event */">onunhandledrejection jest atrybutem obsługi zdarzenia: jego wartość to kod JavaScript. Na elemencie body ustawia obsługę zdarzenia unhandledrejection obiektu Window, a nie osobnego zdarzenia elementu. Nie jest zwykłym globalnym atrybutem HTML dostępnym na każdym elemencie. Odpowiednikiem w JavaScript jest właściwość window.onunhandledrejection.
Powiadomienie jest asynchroniczne. Jeśli obsługa odrzucenia zostanie dołączona odpowiednio wcześnie, zdarzenie nie wystąpi. Obiekt event ma typ PromiseRejectionEvent: event.promise wskazuje odrzuconą obietnicę, a event.reason zawiera powód odrzucenia.
Wywołanie event.preventDefault() anuluje domyślne raportowanie tego zdarzenia w konsoli; nie naprawia obietnicy. Obsługuj przewidywane błędy przy ich źródle, zamiast polegać wyłącznie na globalnym powiadomieniu.
Przykład ustawia atrybut na body i obsługuje odrzucenie obietnicy za pomocą promise.catch(() => {}). To window.dispatchEvent() przekazuje do window syntetyczne zdarzenie unhandledrejection, które można anulować, i w ten sposób uruchamia procedurę obsługi wypisującą event.reason w konsoli. Przykład pokazuje, że procedura obsługi jest podłączona poprawnie, a nie jak przeglądarka powiadamia o nieobsłużonym odrzuceniu. Wywołanie event.preventDefault() dotyczy tu tylko zdarzenia syntetycznego i nie pokazuje, jak przeglądarka pomija domyślne raportowanie nieobsłużonego odrzucenia. Kod inline wymaga odpowiednich uprawnień polityki bezpieczeństwa strony.
Przykłady
<!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>Wynik
reason: demo
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.