База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

window.onerror — глобална обработка на грешки в скриптове

window.onerror обработва събития error, докладвани на прозореца. При ErrorEvent функцията получава пет аргумента. Връщането на true отменя стандартното докладване на грешката, но не продължава прекъснатия код.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

window.onerror е свойството на обекта Window за обработчик на събитието error и се използва за наблюдение на необхванати грешки в скриптове. То принадлежи към стандарта HTML, а не към конкретно издание на ECMAScript. Съвременните браузърни енджини го поддържат; наличието на Node 24 в хранилище не доказва поддръжка на този браузърен API.

При ErrorEvent функцията получава message (съобщение за грешка), source (URL на скрипта), lineno (ред), colno (колона) и error (докладваната стойност, която не е задължително обект Error). Някои подробности може да липсват: при заглушени грешки в скриптове от друг произход съобщението е Script error., URL адресът е празен, координатите са 0, а error е null.

Връщането точно на true отменя стандартното докладване; false и undefined не го правят. Това нито поправя грешката, нито продължава прекъснатото изпълнение. window.addEventListener("error", handler) получава един обект на събитие; за отмяна се използва event.preventDefault(), а не върнатата стойност.

Присвояването заменя предишния обработчик, а null го премахва. Необработените отхвърляния на обещания се обработват чрез unhandledrejection, а не чрез window.onerror. Примерът изпраща синтетичен ErrorEvent с фиксирани данни и възстановява предишния обработчик; той не предизвиква реално необхванато изключение.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници