Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

PromiseRejectionEvent.reason — razlog zavrnitve obljube

PromiseRejectionEvent.reason razkrije razlog zavrnitve v dogodkih unhandledrejection in rejectionhandled. Lastnost je samo za branje, njena vrednost pa je lahko katera koli vrednost JavaScripta, ne le objekt Error.

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

Sintaksa

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

PromiseRejectionEvent je vmesnik Web API, ki podeduje od Event in ni del samega ECMAScripta. Lastnost PromiseRejectionEvent.reason, prebrana kot event.reason, vsebuje razlog zavrnitve. To je lahko niz, število, Error, drug objekt ali undefined; zato ne predpostavljajte, da event.reason.message obstaja.

reason je samo za branje. Nasprotno pa event.promise označuje obljubo, povezano z dogodkom: ti lastnosti predstavljata razlog oziroma obljubo, ne pa dveh načinov branja istega elementa.

unhandledrejection sporoča zavrnitev, za katero ni na voljo obravnavalnika. rejectionhandled pomeni, da je bil obravnavalnik dodan pozneje, potem ko je bil unhandledrejection že sporočen. Globalni poslušalniki pomagajo pri diagnostiki, ne nadomestijo pa obravnave napak z .catch() ali try/catch okoli await.

Primer ročno ustvari dogodek, da dostop do lastnosti prikaže na predvidljiv način. Argument konstruktorja reason nastavi vrednost v tem sintetičnem dogodku; ustvarjanje dogodka ne zavrne obljube in dogodka ne sproži. Takojšnji .catch() prepreči resnično neobravnavano zavrnitev.

Primer zaženite v brskalniku, ki omogoča PromiseRejectionEvent. Ta API je na voljo tudi v Web Workers; prisotnost Promise ali uporaba Node 24 ne dokazuje podpore za ta brskalniški vmesnik.

Primeri

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

Rezultat

TASK_FAILED
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri