CKTIS / JavaScript
HTMLElement.onerror — gestionar el evento error
HTMLElement.onerror asigna un controlador al evento error de un elemento, por ejemplo, cuando falla la carga de una imagen. No es un mecanismo global para capturar excepciones de JavaScript.
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
element.onerror = function (event) { /* handle error */ };
element.onerror = null;HTMLElement.onerror es la propiedad controladora del evento error. En un elemento ordinario, la función recibe un objeto de evento, no los cinco argumentos asociados a la gestión global de errores.
Asignar una función reemplaza el valor anterior de esta propiedad; asignar null elimina ese controlador. Para registrar funciones independientes, usa addEventListener('error', handler).
No confundas esta propiedad con window.onerror: al informar de una excepción, el controlador global recibe message, source, lineno, colno, error, y devolver true cancela el evento. En un elemento ordinario, devolver false solo cancela el evento si este se puede cancelar. Las propiedades onerror de body y frameset tienen un comportamiento especial que reenvía el evento a Window.
El ejemplo despacha un evento sintético sin obtener recursos. Comprueba la invocación y la eliminación del controlador, no un fallo real de carga. Esta es una API del navegador definida por HTML, no una característica del lenguaje ECMAScript; Node 24 no demuestra que esté disponible.
Ejemplos
(() => {
const element = document.createElement('img');
element.onerror = function (event) {
console.log(`${event.type}: ${event.target === element}`);
};
element.dispatchEvent(new Event('error'));
element.onerror = null;
element.dispatchEvent(new Event('error'));
})();Resultado
error: 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.