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

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.

Fuentes