Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLElement.onload — gérer le chargement d’une ressource

HTMLElement.onload est la propriété de gestionnaire d’événement pour load. On lui affecte une fonction pour réagir au chargement d’une ressource d’un élément, comme une image. Une affectation ultérieure remplace la fonction précédente, tandis que null désactive ce gestionnaire.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

element.onload = function (event) { /* handle load */ };
element.onload = null;

HTMLElement.onload est la propriété de gestionnaire d’événement pour load, exposée par le mécanisme GlobalEventHandlers. Il s’agit d’une interface de navigateur définie par HTML, et non d’une fonctionnalité d’ECMAScript lui-même ; la présence de Node.js 24 ne prouve pas qu’elle y est disponible.

Pour une image, load signifie que la ressource a été chargée avec succès. Définissez la fonction avant d’affecter src afin de ne pas manquer l’événement. Le fait qu’un élément possède cette propriété ne signifie pas que chaque élément émet automatiquement load. Les éléments body et frameset constituent un cas particulier : leur onload gère l’événement sur Window, et non le chargement d’une ressource propre à l’élément.

Affecter une nouvelle fonction remplace la précédente ; null supprime ce gestionnaire. Utilisez addEventListener('load', handler) pour des abonnements indépendants. Dans l’exemple, l’image mesure 1x1 et la fonction reçoit event. La fonction ordinaire utilise this pour faire référence à l’image.

Exemples

(() => {
  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>'
  );
})();

Résultat

load: 1x1

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources