CKTIS / JavaScript
unhandledrejection — neošetřené odmítnutí Promise
Událost unhandledrejection oznamuje odmítnutí Promise, které zůstalo neošetřené v okamžiku, kdy je prohlížeč oznámí. Zpřístupňuje Promise a důvod odmítnutí; slouží k diagnostice, nikoli jako náhrada místního ošetření chyb.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
window.addEventListener("unhandledrejection", (event) => { /* event.promise, event.reason */ });unhandledrejection je událost webové platformy odesílaná globálnímu objektu, například window, jako PromiseRejectionEvent. Nejde o syntaxi ECMAScriptu. event.promise označuje odmítnutý objekt Promise a event.reason obsahuje důvod odmítnutí — libovolnou hodnotu, ne nutně objekt Error.
Oznámení je asynchronní: prohlížeč bere v úvahu handlery přidané během zpracování mikrotasků a před odesláním události znovu kontroluje stav ošetření. Samotné Promise.reject() proto událost nezaručuje. Včasné přidání .catch() jí může zabránit; handler přidaný až po oznámení může vyvolat samostatnou událost rejectionhandled.
Událost lze zrušit. event.preventDefault() potlačí výchozí oznámení tohoto odmítnutí v konzoli, ale nezmění stav objektu Promise ani nenahrazuje .catch() nebo try/catch kolem await. Používejte jej uvážlivě, abyste neskrývali chyby. Tento mechanismus není úplným záznamem chyb: sledování se vynechává u skriptů s příznakem muted errors, včetně některých případů skriptů z jiného původu.
Příklad filtruje události podle identity objektu Promise, vypíše důvod a odstraní posluchač. Spusťte jej jako skript na prázdné stránce v prohlížeči, nikoli v Node.js. Toto API definuje HTML Living Standard; vydání ECMAScriptu ani přítomnost Node 24 nepotvrzuje podporu v prohlížeči.
Příklady
(() => {
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");
})();Výsledek
unhandled: demo
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.