Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

PromiseRejectionEvent.reason — powód odrzucenia obietnicy

Właściwość PromiseRejectionEvent.reason udostępnia powód odrzucenia obietnicy w zdarzeniach unhandledrejection i rejectionhandled. Jest tylko do odczytu, ale jej wartością może być dowolna wartość JavaScript, nie tylko obiekt Error.

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

event.reason
new PromiseRejectionEvent(type, { promise, reason })

PromiseRejectionEvent to interfejs Web API dziedziczący po Event, a nie część samego ECMAScript. Właściwość PromiseRejectionEvent.reason, odczytywana jako event.reason, zawiera powód odrzucenia. Może to być tekst, liczba, obiekt Error, inny obiekt lub undefined; nie zakładaj więc, że istnieje event.reason.message.

reason jest właściwością tylko do odczytu. Natomiast event.promise wskazuje obietnicę, której dotyczy zdarzenie: te właściwości oznaczają odpowiednio powód i obietnicę, a nie dwa sposoby odczytu tego samego elementu.

unhandledrejection informuje o odrzuceniu bez dostępnej procedury obsługi. rejectionhandled oznacza, że procedurę obsługi dołączono później, już po zgłoszeniu unhandledrejection. Globalny nasłuch pomaga w diagnostyce, ale nie zastępuje obsługi błędów za pomocą .catch() lub try/catch wokół await.

Przykład tworzy zdarzenie ręcznie, aby deterministycznie pokazać odczyt właściwości. Argument reason konstruktora ustala wartość w takim syntetycznym zdarzeniu; samo utworzenie zdarzenia nie odrzuca obietnicy ani go nie wysyła. Natychmiastowe .catch() zapobiega rzeczywistemu nieobsłużonemu odrzuceniu.

Uruchamiaj przykład w przeglądarce udostępniającej PromiseRejectionEvent. To API występuje również w Web Workers; obecność Promise lub używanie Node 24 nie dowodzą dostępności tego interfejsu przeglądarkowego.

Przykłady

(() => {
  const reason = "TASK_FAILED";
  const promise = Promise.reject(reason);
  promise.catch(() => {});

  const event = new PromiseRejectionEvent("unhandledrejection", {
    promise,
    reason,
  });

  console.log(event.reason);
  console.log(event.promise === promise);
})();

Wynik

TASK_FAILED
true

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

Źródła