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.