CKTIS / JavaScript
unhandledrejection — neošetrené odmietnutie Promise
Udalosť unhandledrejection oznamuje odmietnutie Promise, ktoré zostalo neošetrené v čase, keď ho prehliadač oznamuje. Sprístupňuje Promise a dôvod odmietnutia; slúži na diagnostiku, nie ako náhrada lokálneho ošetrenia chýb.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.addEventListener("unhandledrejection", (event) => { /* event.promise, event.reason */ });unhandledrejection je udalosť webovej platformy odosielaná globálnemu objektu, napríklad window, ako PromiseRejectionEvent. Nie je to syntax ECMAScriptu. event.promise označuje odmietnutý objekt Promise a event.reason obsahuje dôvod odmietnutia — ľubovoľnú hodnotu, nie nevyhnutne objekt Error.
Oznámenie je asynchrónne: prehliadač berie do úvahy handlery pridané počas spracovania mikrotaskov a pred odoslaním udalosti znova kontroluje stav ošetrenia. Samotné Promise.reject() preto udalosť nezaručuje. Včasné pridanie .catch() jej môže zabrániť; handler pridaný až po oznámení môže vyvolať samostatnú udalosť rejectionhandled.
Udalosť možno zrušiť. event.preventDefault() potlačí predvolené oznámenie tohto odmietnutia v konzole, ale nezmení stav objektu Promise ani nenahrádza .catch() alebo try/catch okolo await. Používajte ho uvážene, aby ste neskrývali chyby. Tento mechanizmus nie je úplným záznamom chýb: sledovanie sa vynecháva pri skriptoch s príznakom muted errors, vrátane niektorých prípadov skriptov z iného pôvodu.
Príklad filtruje udalosti podľa identity objektu Promise, vypíše dôvod a odstráni poslucháča. Spustite ho ako skript na prázdnej stránke v prehliadači, nie v Node.js. Toto API definuje HTML Living Standard; vydanie ECMAScriptu ani prítomnosť Node 24 nepotvrdzujú podporu v prehliadači.
Prí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ýsledok
unhandled: demo
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.