Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

PromiseRejectionEvent.reason — důvod zamítnutí příslibu

PromiseRejectionEvent.reason zpřístupňuje důvod zamítnutí v událostech unhandledrejection a rejectionhandled. Tato vlastnost je pouze pro čtení, její hodnota však může být libovolná hodnota JavaScriptu, nejen objekt Error.

Verze: 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 je rozhraní Web API, které dědí z Event a není součástí samotného ECMAScriptu. Vlastnost PromiseRejectionEvent.reason, čtená jako event.reason, obsahuje důvod zamítnutí. Může jít o řetězec, číslo, Error, jiný objekt nebo undefined; nepředpokládejte proto, že event.reason.message existuje.

reason je pouze pro čtení. Naproti tomu event.promise označuje příslib spojený s událostí: tyto vlastnosti představují důvod a příslib, nikoli dva způsoby čtení stejné položky.

unhandledrejection oznamuje zamítnutí, pro které není k dispozici obslužná funkce. rejectionhandled znamená, že obslužná funkce byla přidána později, až poté, co už bylo oznámeno unhandledrejection. Globální posluchače pomáhají při diagnostice, nenahrazují však zpracování chyb pomocí .catch() nebo try/catch kolem await.

Příklad vytváří událost ručně, aby přístup k vlastnosti ukázal předvídatelným způsobem. Argument konstruktoru reason nastaví hodnotu v této syntetické události; vytvoření události nezamítne příslib ani událost neodešle. Okamžité .catch() zabrání skutečnému neošetřenému zamítnutí.

Příklad spusťte v prohlížeči, který zpřístupňuje PromiseRejectionEvent. Toto API je dostupné také ve Web Workers; přítomnost Promise ani používání Node 24 nedokládá podporu tohoto rozhraní prohlížeče.

Příklady

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

Výsledek

TASK_FAILED
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje