CKTIS / JavaScript
PromiseRejectionEvent.reason — motivo de rechazo de una promesa
PromiseRejectionEvent.reason expone el motivo de rechazo en los eventos unhandledrejection y rejectionhandled. La propiedad es de solo lectura, pero su valor puede ser cualquier valor de JavaScript, no solo un objeto Error.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
event.reason
new PromiseRejectionEvent(type, { promise, reason })PromiseRejectionEvent es una interfaz de Web API que hereda de Event, no forma parte de ECMAScript. La propiedad PromiseRejectionEvent.reason, que se lee como event.reason, contiene el motivo del rechazo. Puede ser una cadena, un número, un Error, otro objeto o undefined; por tanto, no des por hecho que existe event.reason.message.
reason es de solo lectura. En cambio, event.promise identifica la promesa asociada al evento: estas propiedades representan, respectivamente, el motivo y la promesa, no dos formas de leer el mismo elemento.
unhandledrejection informa de un rechazo sin un controlador disponible. rejectionhandled significa que se añadió un controlador más tarde, después de que ya se hubiera informado de unhandledrejection. Los escuchadores globales ayudan con el diagnóstico, pero no sustituyen la gestión de errores mediante .catch() o try/catch alrededor de await.
El ejemplo construye un evento manualmente para mostrar de forma determinista el acceso a la propiedad. El argumento reason del constructor establece el valor en este evento sintético; construir el evento no rechaza una promesa ni lo envía. El .catch() inmediato evita un rechazo real sin gestionar.
Ejecuta el ejemplo en un navegador que exponga PromiseRejectionEvent. Esta API también está disponible en Web Workers; la presencia de Promise o el uso de Node 24 no demuestra que se admita esta interfaz del navegador.
Ejemplos
(() => {
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);
})();Resultado
TASK_FAILED true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.