WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLElement.onload — Laden einer Ressource behandeln

HTMLElement.onload ist die Event-Handler-Eigenschaft für load. Weise ihr eine Funktion zu, um auf das Laden einer Elementressource, etwa eines Bildes, zu reagieren. Eine spätere Zuweisung ersetzt die vorherige Funktion; null deaktiviert den Handler.

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

Syntax

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

HTMLElement.onload ist die Event-Handler-Eigenschaft für load, die über den Mechanismus GlobalEventHandlers bereitgestellt wird. Sie gehört zu einer durch HTML definierten Browser-Schnittstelle und ist keine Funktion von ECMAScript selbst; die Verfügbarkeit von Node.js 24 belegt nicht, dass sie dort verfügbar ist.

Bei einem Bild bedeutet load, dass die Ressource erfolgreich geladen wurde. Weise die Funktion zu, bevor du src setzt, damit das Ereignis nicht verpasst wird. Dass die Eigenschaft bei einem Element vorhanden ist, bedeutet nicht, dass jedes Element automatisch load auslöst. Eine Besonderheit sind die Elemente body und frameset: Ihr onload behandelt das Ereignis von Window, nicht das Laden einer separaten Elementressource.

Eine neue Funktionszuweisung ersetzt die bisherige; null entfernt diesen Handler. Für unabhängige Abonnements kannst du addEventListener('load', handler) verwenden. Im Beispiel hat das Bild die Größe 1x1, und die Funktion erhält event. Die gewöhnliche Funktion verwendet this, um auf das Bild zu verweisen.

Beispiele

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

Ergebnis

load: 1x1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen