Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

window.onerror — globalna obravnava napak skriptov

window.onerror obravnava dogodke error, sporočene oknu. Pri objektu ErrorEvent funkcija prejme pet argumentov. Vrnitev true prekliče privzeto poročanje o napaki, vendar ne nadaljuje prekinjene kode.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

window.onerror = (message, source, lineno, colno, error) => { /* return true to cancel default reporting */ };
window.onerror = null;

window.onerror je lastnost objekta Window za obravnavo dogodka error, ki se uporablja za spremljanje neulovljenih napak skriptov. Spada v standard HTML, ne v določeno izdajo ECMAScripta. Sodobni brskalniški pogoni jo podpirajo; prisotnost Node 24 v repozitoriju ne dokazuje podpore temu brskalniškemu API-ju.

Pri objektu ErrorEvent funkcija prejme message (sporočilo o napaki), source (URL skripta), lineno (vrstica), colno (stolpec) in error (sporočeno vrednost, ki ni nujno objekt Error). Podrobnosti morda niso na voljo: pri utišanih napakah skriptov z drugega izvora je sporočilo Script error., URL je prazen, koordinate so 0 in error je null.

Vrnitev natanko true prekliče privzeto poročanje; false in undefined tega ne storita. S tem napake ne odpravite in ne nadaljujete prekinjenega izvajanja. window.addEventListener("error", handler) prejme en sam objekt dogodka; za preklic uporabite event.preventDefault(), ne vrnjene vrednosti.

Dodelitev zamenja prejšnji obravnavalnik, null pa ga odstrani. Neobravnavane zavrnitve Promise se obravnavajo z unhandledrejection, ne z window.onerror. Primer sproži sintetični ErrorEvent s fiksnimi podatki in obnovi prejšnji obravnavalnik; ne povzroči prave neulovljene izjeme.

Primeri

(() => {
  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;
  }
})();

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri