CKTIS / JavaScript
unhandledrejection — neobravnavana zavrnitev Promise
Dogodek unhandledrejection sporoči zavrnitev Promise, ki ob obvestilu brskalnika še ni obravnavana. Razkrije Promise in razlog zavrnitve; namenjen je diagnostiki, ne nadomešča pa lokalne obravnave napak.
Različica: 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 dogodek spletne platforme, ki se kot PromiseRejectionEvent pošlje globalnemu objektu, na primer window. Ne gre za sintakso ECMAScript. event.promise označuje zavrnjeni Promise, event.reason pa vsebuje razlog zavrnitve — poljubno vrednost, ne nujno objekt Error.
Obvestilo je asinhrono: brskalnik upošteva obravnavalnike, dodane med obdelavo mikronalog, in pred pošiljanjem dogodka znova preveri stanje obravnave. Zato sam Promise.reject() ne zagotavlja dogodka. Pravočasno dodan .catch() ga lahko prepreči; obravnavalnik, dodan po obvestilu, lahko povzroči ločen dogodek rejectionhandled.
Dogodek je mogoče preklicati. event.preventDefault() prepreči privzeto poročanje o tej zavrnitvi v konzoli, vendar ne spremeni stanja Promise in ne nadomesti .catch() ali try/catch okoli await. Uporabite ga premišljeno, da ne bi prikrili napak. Ta mehanizem ni popoln dnevnik napak: sledenje je izpuščeno pri skriptih z zastavico muted errors, tudi v nekaterih primerih skriptov z drugega izvora.
Primer filtrira dogodke glede na identiteto Promise, izpiše razlog in odstrani poslušalnik. Zaženite ga kot skript na prazni strani brskalnika, ne v Node.js. To API določa HTML Living Standard; izdaja ECMAScript ali prisotnost Node 24 ne potrjuje podpore v brskalniku.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.