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

CKTIS / JavaScript

window.onerror — globální zpracování chyb skriptů

window.onerror zpracovává události error oznámené oknu. U objektu ErrorEvent dostane funkce pět argumentů. Vrácení true zruší výchozí hlášení chyby, ale nepokračuje v přerušeném kódu.

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

window.onerror je vlastnost objektu Window pro obsluhu události error, která slouží k pozorování nezachycených chyb skriptů. Patří do standardu HTML, nikoli do konkrétního vydání ECMAScriptu. Současné prohlížečové enginy ji podporují; přítomnost Node 24 v repozitáři nedokládá podporu tohoto prohlížečového API.

U objektu ErrorEvent dostane funkce message (zpráva o chybě), source (URL skriptu), lineno (řádek), colno (sloupec) a error (oznámená hodnota, která nemusí být objektem Error). Některé podrobnosti nemusí být dostupné: u potlačených chyb skriptů z jiného původu je zpráva Script error., URL je prázdné, souřadnice jsou 0 a error má hodnotu null.

Vrácení přesně true zruší výchozí hlášení; false ani undefined to neudělají. Chybu tím neopravíte ani neobnovíte přerušené provádění. window.addEventListener("error", handler) dostane jediný objekt události; ke zrušení slouží event.preventDefault(), nikoli návratová hodnota.

Přiřazení nahradí předchozí obslužnou funkci a null ji odstraní. Nezpracovaná zamítnutí Promise se obsluhují událostí unhandledrejection, nikoli pomocí window.onerror. Příklad odešle syntetický ErrorEvent s pevně danými údaji a obnoví předchozí obslužnou funkci; nevytvoří skutečnou nezachycenou výjimku.

Pří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ýsledek

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

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