CKTIS / JavaScript
PromiseRejectionEvent.reason — dôvod zamietnutia prísľubu
PromiseRejectionEvent.reason sprístupňuje dôvod zamietnutia v udalostiach unhandledrejection a rejectionhandled. Vlastnosť je iba na čítanie, jej hodnota však môže byť ľubovoľná hodnota JavaScriptu, nielen objekt Error.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.reason
new PromiseRejectionEvent(type, { promise, reason })PromiseRejectionEvent je rozhranie Web API, ktoré dedí z Event a nie je súčasťou samotného ECMAScriptu. Vlastnosť PromiseRejectionEvent.reason, čítaná ako event.reason, obsahuje dôvod zamietnutia. Môže ísť o reťazec, číslo, Error, iný objekt alebo undefined; nepredpokladajte preto, že event.reason.message existuje.
reason je iba na čítanie. Naproti tomu event.promise označuje prísľub spojený s udalosťou: tieto vlastnosti predstavujú dôvod a prísľub, nie dva spôsoby čítania tej istej položky.
unhandledrejection oznamuje zamietnutie, pre ktoré nie je k dispozícii obslužná funkcia. rejectionhandled znamená, že obslužná funkcia bola pridaná neskôr, až po tom, čo už bolo oznámené unhandledrejection. Globálne poslucháče pomáhajú pri diagnostike, nenahrádzajú však spracovanie chýb pomocou .catch() alebo try/catch okolo await.
Príklad vytvára udalosť ručne, aby prístup k vlastnosti ukázal predvídateľným spôsobom. Argument konštruktora reason nastaví hodnotu v tejto syntetickej udalosti; vytvorenie udalosti nezamietne prísľub ani udalosť neodošle. Okamžité .catch() zabráni skutočnému neošetrenému zamietnutiu.
Príklad spustite v prehliadači, ktorý sprístupňuje PromiseRejectionEvent. Toto API je dostupné aj vo Web Workers; prítomnosť Promise ani používanie Node 24 nedokazuje podporu tohto rozhrania prehliadača.
Prí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ýsledok
TASK_FAILED true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.