Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

unhandledrejection — nieobsłużone odrzucenie obietnicy

Zdarzenie unhandledrejection informuje o odrzuceniu Promise, którego nie obsłużono przed zgłoszeniem przez przeglądarkę. Udostępnia obietnicę i powód odrzucenia; służy do diagnostyki, nie zastępuje lokalnej obsługi błędów.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

window.addEventListener("unhandledrejection", (event) => { /* event.promise, event.reason */ });

unhandledrejection to zdarzenie platformy Web, wysyłane do obiektu globalnego, np. window, jako PromiseRejectionEvent. Nie jest składnią ECMAScript. event.promise wskazuje odrzuconą obietnicę, a event.reason zawiera powód odrzucenia — dowolną wartość, niekoniecznie obiekt Error.

Powiadomienie jest asynchroniczne: przeglądarka uwzględnia obsługę dodaną podczas przetwarzania mikrozadań i ponownie sprawdza stan przed wysłaniem zdarzenia. Dlatego samo Promise.reject() nie gwarantuje zdarzenia. Dodanie .catch() odpowiednio wcześnie może mu zapobiec; dodanie obsługi po zgłoszeniu może spowodować osobne rejectionhandled.

Zdarzenie jest anulowalne. event.preventDefault() wyłącza domyślne raportowanie tego odrzucenia do konsoli, lecz nie zmienia stanu obietnicy ani nie zastępuje .catch() lub try/catch wokół await. Używaj go świadomie, aby nie ukrywać usterek. Mechanizm nie jest kompletnym rejestrem błędów: śledzenie jest pomijane dla skryptów z flagą muted errors, m.in. w niektórych przypadkach skryptów między źródłami.

Przykład filtruje zdarzenia według tożsamości obietnicy, wypisuje powód i usuwa nasłuch. Uruchom go jako skrypt pustej strony, nie w Node.js. To API określa HTML Living Standard; wersja ECMAScript ani obecność Node 24 nie potwierdzają jego obsługi w przeglądarce.

Przykłady

(() => {
  let rejected;

  function report(event) {
    if (event.promise !== rejected) return;
    event.preventDefault();
    window.removeEventListener("unhandledrejection", report);
    console.log("unhandled:", event.reason);
  }

  window.addEventListener("unhandledrejection", report);
  rejected = Promise.reject("demo");
})();

Wynik

unhandled: demo

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

Źródła