Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła