WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onerror — ein Fehlerereignis behandeln

Das onerror-Attribut enthält JavaScript zur Behandlung eines error-Ereignisses, etwa wenn ein Bild nicht geladen werden kann. Handler auf Elementen unterscheiden sich von window.onerror durch ihre Argumente und die Bedeutung ihres Rückgabewerts.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };

onerror ist ein Ereignishandler-Attribut für error. Sein Wert ist JavaScript-Code, keine URL. Bei einem gewöhnlichen Element wie img erhält der Code event. Die entsprechende JavaScript-Eigenschaft kann auf eine Funktion gesetzt oder auf null gesetzt werden, um den Handler zu entfernen.

window.onerror hat eine spezielle Signatur: Bei einem ErrorEvent erhält es message, source, lineno, colno, error. Die Rückgabe von true bricht das Ereignis nur ab, wenn es abbrechbar ist, und unterdrückt damit eine etwaige standardmäßige Fehlermeldung. Ein synthetisches ErrorEvent ist standardmäßig nicht abbrechbar und wird daher durch die Rückgabe von true nicht abgebrochen. Unterbrochener Code wird durch die Rückgabe von true nicht fortgesetzt. Ein gewöhnlicher Element-Handler verwendet return false, um ein Ereignis abzubrechen, sofern es abbrechbar ist. Ein an addEventListener('error', ...) übergebener Callback erhält ein einzelnes Ereignisobjekt; sein Rückgabewert bricht das Ereignis nicht ab.

Beim body-Element behandelt das onerror-Attribut Window-Ereignisse und nicht lokale Fehler des body-Elements. Verwechseln Sie es nicht mit der Behandlung von Ressourcenfehlern bei img.

Das Beispiel löst ein synthetisches error-Ereignis aus und benötigt daher weder Netzwerkzugriff noch einen tatsächlichen Ladefehler. Wenn JavaScript aktiviert und Inline-Handler erlaubt sind, sollte das output-Element error anzeigen. Getestet wird der Aufruf des Handlers, nicht das Laden eines Bildes.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>onerror</title>
<img id="image" src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==" alt="Demo" onerror="document.getElementById('result').textContent = event.type;">
<output id="result"></output>
<script>
  document.getElementById('image').dispatchEvent(new Event('error'));
</script>

Ergebnis

error

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