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

CKTIS / JavaScript

window.onerror — globálne spracovanie chýb skriptov

window.onerror spracúva udalosti error oznámené oknu. Pri objekte ErrorEvent dostane funkcia päť argumentov. Vrátenie true zruší predvolené hlásenie chyby, ale nepokračuje v prerušenom kóde.

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.onerror = (message, source, lineno, colno, error) => { /* return true to cancel default reporting */ };
window.onerror = null;

window.onerror je vlastnosť objektu Window na obsluhu udalosti error, ktorá slúži na sledovanie nezachytených chýb skriptov. Patrí do štandardu HTML, nie do konkrétneho vydania ECMAScriptu. Súčasné prehliadačové enginy ju podporujú; prítomnosť Node 24 v repozitári nedokazuje podporu tohto prehliadačového API.

Pri objekte ErrorEvent dostane funkcia message (chybové hlásenie), source (URL skriptu), lineno (riadok), colno (stĺpec) a error (oznámenú hodnotu, ktorá nemusí byť objektom Error). Niektoré podrobnosti nemusia byť dostupné: pri potlačených chybách skriptov z iného pôvodu je hlásenie Script error., URL je prázdne, súradnice sú 0 a error má hodnotu null.

Vrátenie presne true zruší predvolené hlásenie; false ani undefined to neurobia. Chybu tým neopravíte ani neobnovíte prerušené vykonávanie. window.addEventListener("error", handler) dostane jediný objekt udalosti; na zrušenie slúži event.preventDefault(), nie návratová hodnota.

Priradenie nahradí predchádzajúcu obslužnú funkciu a null ju odstráni. Nespracované zamietnutia Promise sa obsluhujú udalosťou unhandledrejection, nie pomocou window.onerror. Príklad odošle syntetický ErrorEvent s pevnými údajmi a obnoví predchádzajúcu obslužnú funkciu; nevytvorí skutočnú nezachytenú výnimku.

Príklady

(() => {
  const previous = window.onerror;
  const failure = new Error("Demo");
  window.onerror = (message, source, lineno, colno, error) => {
    console.log(`${message}|${source}|${lineno}|${colno}|${error === failure}`);
    return true;
  };
  try {
    const event = new ErrorEvent("error", {
      message: "Demo",
      filename: "demo.js",
      lineno: 7,
      colno: 3,
      error: failure,
      cancelable: true
    });
    window.dispatchEvent(event);
    console.log(`canceled=${event.defaultPrevented}`);
  } finally {
    window.onerror = previous;
  }
})();

Výsledok

Demo|demo.js|7|3|true
canceled=true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje