Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje