CKTIS / JavaScript
PromiseRejectionEvent.reason — razlog odbijanja obećanja
PromiseRejectionEvent.reason izlaže razlog odbijanja u događajima unhandledrejection i rejectionhandled. Svojstvo je samo za čitanje, ali njegova vrijednost može biti bilo koja JavaScript vrijednost, a ne samo objekt Error.
Verzija: 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 sučelje Web API-ja koje nasljeđuje od Event i nije dio samog ECMAScripta. Svojstvo PromiseRejectionEvent.reason, koje se čita kao event.reason, sadrži razlog odbijanja. To može biti niz znakova, broj, Error, drugi objekt ili undefined; zato nemojte pretpostaviti da event.reason.message postoji.
reason je samo za čitanje. Nasuprot tome, event.promise označava obećanje povezano s događajem: ta svojstva predstavljaju razlog, odnosno obećanje, a ne dva načina čitanja iste stavke.
unhandledrejection prijavljuje odbijanje za koje nije dostupan rukovatelj. rejectionhandled znači da je rukovatelj dodan kasnije, nakon što je unhandledrejection već prijavljen. Globalni osluškivači pomažu u dijagnostici, ali ne zamjenjuju obradu pogrešaka pomoću .catch() ili try/catch oko await.
Primjer ručno stvara događaj kako bi pristup svojstvu prikazao na predvidljiv način. Argument konstruktora reason postavlja vrijednost u tom sintetičkom događaju; stvaranje događaja ne odbija obećanje niti ga otprema. Trenutačni .catch() sprječava stvarno neobrađeno odbijanje.
Primjer pokrenite u pregledniku koji izlaže PromiseRejectionEvent. Taj je API dostupan i u Web Workers; prisutnost Promise ili uporaba Node 24 ne dokazuje podršku za ovo sučelje preglednika.
Primjeri
(() => {
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.