Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onerror — gestionar un evento de error

El atributo onerror contiene código JavaScript que gestiona un evento error, por ejemplo cuando no se puede cargar una imagen. Los manejadores de elementos se diferencian de window.onerror por los argumentos que reciben y por el significado del valor que devuelven.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };

onerror es un atributo que permite gestionar el evento error. Su valor es código JavaScript, no una URL. En un elemento como img, el código recibe event. A la propiedad de JavaScript correspondiente se le puede asignar una función, o bien null para eliminar el manejador.

window.onerror tiene una firma especial: para un ErrorEvent, recibe message, source, lineno, colno, error. Devolver true cancela el evento solo si es cancelable e impide así que se notifique el error de forma predeterminada. Un ErrorEvent sintético no es cancelable de forma predeterminada, así que devolver true no lo cancela. Devolver true no reanuda la ejecución del código interrumpido. Un manejador de un elemento usa return false para cancelar un evento si este es cancelable. La función que se pasa a addEventListener('error', ...) como manejador recibe un único objeto de evento, y el valor que devuelve no cancela el evento.

En el elemento body, el atributo onerror gestiona los eventos de Window, no los errores locales del elemento body. No lo confundas con la gestión de errores de carga de recursos en img.

El ejemplo despacha un evento sintético de tipo error, por lo que no necesita acceso a la red ni un fallo de carga real. Si JavaScript está habilitado y se permiten los manejadores en línea, el elemento output debería mostrar error. El ejemplo comprueba que se ejecuta el manejador, no que se carga la imagen.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>onerror</title>
<img id="image" src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==" alt="Demo" onerror="document.getElementById('result').textContent = event.type;">
<output id="result"></output>
<script>
  document.getElementById('image').dispatchEvent(new Event('error'));
</script>

Resultado

error

La imagen se incluye mediante una URL de datos. El resultado esperado, `error`, corresponde al evento sintético y no depende de que falle la carga de la imagen.

Fuentes