CKTIS / JavaScript
window.onerror — tratamento global de erros de scripts
window.onerror trata os eventos error comunicados à janela. Para um ErrorEvent, a função recebe cinco argumentos. Devolver true cancela a comunicação predefinida do erro, mas não retoma o código interrompido.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
window.onerror = (message, source, lineno, colno, error) => { /* return true to cancel default reporting */ };
window.onerror = null;window.onerror é a propriedade de tratamento do evento error do objeto Window, utilizada para observar erros de scripts não intercetados. Faz parte da norma HTML, não de uma edição específica de ECMAScript. Os motores dos browsers atuais suportam-na; a presença de Node 24 num repositório não comprova o suporte desta API de browser.
Para um ErrorEvent, a função recebe message (mensagem de erro), source (URL do script), lineno (linha), colno (coluna) e error (o valor comunicado, que não é necessariamente um objeto Error). Alguns detalhes podem não estar disponíveis: nos erros silenciosos de scripts entre origens, a mensagem é Script error., o URL está vazio, as coordenadas são 0 e error é null.
Devolver exatamente true cancela a comunicação predefinida; false e undefined não o fazem. Isto não corrige o erro nem retoma a execução interrompida. window.addEventListener("error", handler) recebe um único objeto de evento; para o cancelar, usa-se event.preventDefault(), não o valor devolvido.
A atribuição substitui o handler anterior e null remove-o. As rejeições de promessas não tratadas são tratadas com unhandledrejection, não com window.onerror. O exemplo envia um ErrorEvent sintético com dados fixos e repõe o handler anterior; não produz uma exceção real não intercetada.
Exemplos
(() => {
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;
}
})();Resultado
Demo|demo.js|7|3|true canceled=true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.