Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje