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.