Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

PromiseRejectionEvent.reason — motif de rejet d’une promesse

PromiseRejectionEvent.reason expose le motif de rejet dans les événements unhandledrejection et rejectionhandled. Cette propriété est en lecture seule, mais sa valeur peut être n’importe quelle valeur JavaScript, et pas seulement un objet Error.

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

Syntaxe

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

PromiseRejectionEvent est une interface d’API Web qui hérite de Event et ne fait pas partie d’ECMAScript lui-même. La propriété PromiseRejectionEvent.reason, lue sous la forme event.reason, contient le motif de rejet. Il peut s’agir d’une chaîne, d’un nombre, d’une valeur Error, d’un autre objet ou de undefined ; ne supposez donc pas que event.reason.message existe.

reason est en lecture seule. En revanche, event.promise désigne la promesse associée à l’événement : ces propriétés représentent respectivement le motif et la promesse, et non deux façons de lire le même élément.

unhandledrejection signale un rejet sans gestionnaire de rejet disponible. rejectionhandled signifie qu’un gestionnaire a été ajouté plus tard, après que unhandledrejection a déjà été signalé. Les écouteurs globaux facilitent le diagnostic, mais ne remplacent pas la gestion des erreurs avec .catch() ou try/catch autour de await.

L’exemple construit manuellement un événement afin de montrer l’accès à la propriété de manière déterministe. L’argument reason du constructeur définit la valeur dans cet événement synthétique ; construire l’événement ne rejette pas une promesse et ne déclenche pas l’événement. L’appel immédiat à .catch() évite un véritable rejet non géré.

Exécutez l’exemple dans un navigateur qui expose PromiseRejectionEvent. Cette API est également disponible dans les Web Workers ; la présence de Promise ou l’utilisation de Node 24 ne prouve pas la prise en charge de cette interface de navigateur.

Exemples

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

Résultat

TASK_FAILED
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources