WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLElement.onerror — das error-Ereignis behandeln

HTMLElement.onerror weist einem Element einen Handler für sein error-Ereignis zu, etwa bei einem Fehler beim Laden eines Bildes. Es ist kein globaler Mechanismus zum Abfangen von JavaScript-Ausnahmen.

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.onerror = function (event) { /* handle error */ };
element.onerror = null;

HTMLElement.onerror ist die Ereignishandler-Eigenschaft für error. Bei einem gewöhnlichen Element erhält die Funktion ein Ereignisobjekt und nicht die fünf Argumente, die zur globalen Fehlerbehandlung gehören.

Das Zuweisen einer Funktion ersetzt den vorherigen Wert dieser Eigenschaft; durch Zuweisen von null wird der Handler entfernt. Um unabhängige Funktionen zu registrieren, verwende addEventListener('error', handler).

Verwechsle diese Eigenschaft nicht mit window.onerror: Beim Melden einer Ausnahme erhält der globale Handler message, source, lineno, colno, error; die Rückgabe von true bricht das Ereignis ab. Bei einem gewöhnlichen Element bricht die Rückgabe von false das Ereignis nur ab, wenn es abbrechbar ist. Die onerror-Eigenschaften von body und frameset leiten Ereignisse auf besondere Weise an Window weiter.

Das Beispiel löst ein synthetisches Ereignis aus, ohne Ressourcen abzurufen. Es prüft den Aufruf und das Entfernen des Handlers, nicht einen tatsächlichen Ladefehler. Dies ist eine durch HTML definierte Browser-API und kein ECMAScript-Sprachmerkmal; Node 24 belegt nicht, dass sie verfügbar ist.

Beispiele

(() => {
  const element = document.createElement('img');
  element.onerror = function (event) {
    console.log(`${event.type}: ${event.target === element}`);
  };
  element.dispatchEvent(new Event('error'));
  element.onerror = null;
  element.dispatchEvent(new Event('error'));
})();

Ergebnis

error: true

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