CKTIS / JavaScript
PromiseRejectionEvent.reason — причина за отхвърляне на обещание
PromiseRejectionEvent.reason предоставя причината за отхвърляне в събитията unhandledrejection и rejectionhandled. Свойството е само за четене, но стойността му може да бъде всякаква стойност на JavaScript, а не само обект Error.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
event.reason
new PromiseRejectionEvent(type, { promise, reason })PromiseRejectionEvent е интерфейс на Web API, който наследява Event и не е част от самия ECMAScript. Свойството PromiseRejectionEvent.reason, прочетено като event.reason, съдържа причината за отхвърляне. Тя може да бъде низ, число, Error, друг обект или undefined; затова не приемайте, че event.reason.message съществува.
reason е само за четене. За разлика от него event.promise указва обещанието, свързано със събитието: тези свойства представляват съответно причината и обещанието, а не два начина за прочитане на един и същ елемент.
unhandledrejection съобщава за отхвърляне, за което няма наличен обработчик. rejectionhandled означава, че обработчик е добавен по-късно, след като unhandledrejection вече е било съобщено. Глобалните слушатели помагат при диагностика, но не заместват обработката на грешки с .catch() или try/catch около await.
Примерът създава събитие ръчно, за да покаже достъпа до свойството по предвидим начин. Аргументът reason на конструктора задава стойността в това синтетично събитие; създаването на събитието нито отхвърля обещание, нито изпраща събитието. Незабавното .catch() предотвратява реално необработено отхвърляне.
Изпълнете примера в браузър, който предоставя PromiseRejectionEvent. Този API е наличен и в Web Workers; наличието на Promise или използването на Node 24 не доказва поддръжка на този браузърен интерфейс.
Примери
(() => {
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);
})();Резултат
TASK_FAILED true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.