CKTIS / JavaScript
HTMLElement.onload — gestionar la carga de recursos
HTMLElement.onload es la propiedad del controlador del evento load. Se le asigna una función para reaccionar a la carga del recurso de un elemento, como una imagen. Una asignación posterior sustituye la función anterior, mientras que null desactiva el controlador.
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.onload = function (event) { /* handle load */ };
element.onload = null;HTMLElement.onload es la propiedad del controlador del evento load, expuesta mediante el mecanismo GlobalEventHandlers. Es una interfaz del navegador definida por HTML, no una característica del propio ECMAScript; disponer de Node.js 24 no demuestra que esté disponible.
En una imagen, load significa que el recurso se ha cargado correctamente. Asigna la función antes de establecer src para no perder el evento. Que un elemento tenga esta propiedad no significa que todos los elementos emitan load automáticamente. Los elementos body y frameset son un caso especial: su onload gestiona el evento de Window, no la carga de un recurso independiente del elemento.
Asignar una función nueva sustituye la anterior; null elimina ese controlador. Usa addEventListener('load', handler) para suscripciones independientes. En el ejemplo, la imagen mide 1x1 y la función recibe event. La función ordinaria utiliza this para hacer referencia a la imagen.
Ejemplos
(() => {
const image = document.createElement('img');
image.onload = function (event) {
console.log(event.type + ': ' + this.naturalWidth + 'x' + this.naturalHeight);
this.onload = null;
};
image.onerror = () => console.log('error');
image.src = 'data:image/svg+xml,' + encodeURIComponent(
'<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"></svg>'
);
})();Resultado
load: 1x1
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.