CKTIS / JavaScript
window.onerror — gestión global de errores de scripts
window.onerror gestiona los eventos error notificados a la ventana. Para un ErrorEvent, la función recibe cinco argumentos. Devolver true cancela la notificación de errores predeterminada, pero no reanuda el código interrumpido.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
window.onerror = (message, source, lineno, colno, error) => { /* return true to cancel default reporting */ };
window.onerror = null;window.onerror es la propiedad de gestión del evento error del objeto Window y se usa para observar errores de scripts no capturados. Pertenece al estándar HTML, no a una edición concreta de ECMAScript. Los motores de navegador actuales la admiten; que un repositorio incluya Node 24 no demuestra que admita esta API de navegador.
Para un ErrorEvent, la función recibe message (mensaje de error), source (URL del script), lineno (línea), colno (columna) y error (el valor notificado, que no tiene por qué ser un objeto Error). Puede que no haya detalles disponibles: los errores silenciosos de scripts entre orígenes tienen el mensaje Script error., una URL vacía, coordenadas 0 y error con valor null.
Devolver exactamente true cancela la notificación predeterminada; false y undefined no lo hacen. Esto no corrige el error ni reanuda la ejecución interrumpida. window.addEventListener("error", handler) recibe un único objeto de evento; para cancelarlo se usa event.preventDefault(), no el valor de retorno.
La asignación reemplaza el controlador anterior y null lo elimina. Los rechazos de promesas no gestionados se tratan con unhandledrejection, no con window.onerror. El ejemplo envía un ErrorEvent sintético con datos fijos y restaura el controlador anterior; no produce una excepción real no capturada.
Ejemplos
(() => {
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.