Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori