База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници