Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

unhandledrejection — neobrađeno odbijanje Promisea

Događaj unhandledrejection prijavljuje odbijanje Promisea koje nije obrađeno u trenutku kad ga preglednik prijavi. Omogućuje pristup promiseu i razlogu odbijanja; služi dijagnostici, a ne zamjenjuje lokalnu obradu pogrešaka.

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

window.addEventListener("unhandledrejection", (event) => { /* event.promise, event.reason */ });

unhandledrejection je događaj web-platforme koji se šalje globalnom objektu, primjerice window, kao PromiseRejectionEvent. Nije riječ o sintaksi ECMAScripta. event.promise označava odbijeni promise, a event.reason sadrži razlog odbijanja — bilo koju vrijednost, ne nužno objekt Error.

Obavijest je asinkrona: preglednik uzima u obzir rukovatelje dodane tijekom obrade mikrozadataka i ponovno provjerava stanje obrade prije slanja događaja. Zato sam Promise.reject() ne jamči događaj. Pravodobno dodavanje .catch() može ga spriječiti; rukovatelj dodan nakon obavijesti može izazvati zaseban događaj rejectionhandled.

Događaj se može otkazati. event.preventDefault() potiskuje zadano prijavljivanje tog odbijanja u konzoli, ali ne mijenja stanje promisea niti zamjenjuje .catch() ili try/catch oko await. Upotrebljavajte ga promišljeno kako ne biste prikrili nedostatke. Ovaj mehanizam nije potpun zapisnik pogrešaka: praćenje se preskače za skripte sa zastavicom muted errors, uključujući neke slučajeve skripti s druge domene.

Primjer filtrira događaje prema identitetu promisea, ispisuje razlog i uklanja slušatelja. Pokrenite ga kao skriptu na praznoj stranici preglednika, a ne u Node.jsu. Ovaj API definira HTML Living Standard; izdanje ECMAScripta ili prisutnost Nodea 24 ne potvrđuju podršku u pregledniku.

Primjeri

(() => {
  let rejected;

  function report(event) {
    if (event.promise !== rejected) return;
    event.preventDefault();
    window.removeEventListener("unhandledrejection", report);
    console.log("unhandled:", event.reason);
  }

  window.addEventListener("unhandledrejection", report);
  rejected = Promise.reject("demo");
})();

Rezultat

unhandled: demo

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori