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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.