Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

PromiseRejectionEvent.reason — motivo del rifiuto di una promise

PromiseRejectionEvent.reason espone il motivo del rifiuto negli eventi unhandledrejection e rejectionhandled. La proprietà è di sola lettura, ma il suo valore può essere qualsiasi valore JavaScript, non solo un oggetto Error.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

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

PromiseRejectionEvent è un’interfaccia Web API che eredita da Event e non fa parte di ECMAScript. La proprietà PromiseRejectionEvent.reason, letta come event.reason, contiene il motivo del rifiuto. Può essere una stringa, un numero, un Error, un altro oggetto oppure undefined; quindi non dare per scontato che event.reason.message esista.

reason è di sola lettura. event.promise, invece, identifica la promise associata all’evento: queste proprietà rappresentano rispettivamente il motivo e la promise, non due modi per leggere lo stesso elemento.

unhandledrejection segnala un rifiuto senza un gestore disponibile. rejectionhandled significa che un gestore è stato aggiunto in seguito, dopo che unhandledrejection era già stato segnalato. Gli listener globali aiutano nella diagnostica, ma non sostituiscono la gestione degli errori con .catch() o try/catch attorno a await.

L’esempio costruisce manualmente un evento per mostrare l’accesso alla proprietà in modo deterministico. L’argomento reason del costruttore imposta il valore in questo evento sintetico; costruire l’evento non rifiuta una promise né lo invia. Il .catch() immediato evita un vero rifiuto non gestito.

Esegui l’esempio in un browser che espone PromiseRejectionEvent. Questa API è disponibile anche nei Web Workers; la presenza di Promise o l’uso di Node 24 non dimostra il supporto di questa interfaccia del browser.

Esempi

(() => {
  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);
})();

Risultato

TASK_FAILED
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti