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.