Javascript onerror | onabort

Javascript-Fehler: onerror

window.onerror wird nur durch Scriptfehler gezündet, aber nicht durch Benutzerfehler. Heute behandelt try-catch vorausschauend mögliche Fehler, aber jeder Fehler, die nicht von einer try-catch-Anweisung abgefangen wird, erzeugt ein error-Event auf dem Window-Objekt.

error ist an das window-Objekt gebunden und kann nicht in einem HTML-Tag als HTML-Attribut behandelt werden. window.onerror kommt heute mit fünf (früher nur mit drei) indirekten Parametern.

window.onerror = function (errorMsg, 
                           url, 
                           lineNumber, 
                           column, 
                           errorObj) {
…
}

Wenn ein Script nicht wie vorgesehen reagiert, öffnen wir die Console, um nachzusehen, ob und welche Fehler ausgegeben wurden. Das ist effizienter als das Öffnen einer Dialogbox mit alert und die manuelle Suche nach Syntaxfehlern in der Steinzeit von Javascript, aber während der Entwicklung und beim Testen auch schon wieder lästig.

Wenn das Script minifiziert ist, ist eine Fehlermeldung für Zeile 3, auf der sich vielleicht 100 oder mehr Anweisungen drängeln, einfach nur nutzlos. Darüber hinaus testen wir Scripte auch auf den mobilen Geräten, wo eine Konsole nicht unbedingt zur Verfügung steht.

Scriptfehler im Browserfenster

In den modernen Browsern hat sich window.onerror gemausert und unterstützt in Firefox und Chrome fünf Parameter, also zwei weitere neben den altdienten Parametern der Fehlernachricht, der Zeile und der Datei, in der ein Fehler auftratt.

Mac OS Safari macht nicht mit und gibt weiterhin nur die Zeilennummer aus, während Chrome und Firefox vorangehen und den Stack Trace anzeigen – das Fehler-Objekt.

myerrormsg.innerHTML = 
window.onerror = function (errorMsg, url, lineNumber, column, errorObj) {
	myerrormsg.innerHTML = `
		Fehler:  ${errorMsg}
		Script: ${url}
		Zeile: ${lineNumber}
		Spalte: ${column}
		StackTrace: ${errorObj}`;
}

Nur die Scriptfehler von lokalen Scripten werden angezeigt. Wenn Scripte auf einem anderen Server (z.B. einem CDN) liegen, sind die Fehlermeldungen aus Sicherheitsgründen reduziert und in vielen Fällen gibt es nur ein schlichtes verschwiegenes Script Error.

Die Fehlermeldung lässt sich auch diskret auf die Konsole packen und auch leicht formatieren. Dennoch:

console.log ('Fehler:' + errorMsg + 
             '\nScript: ' + url + 
             '\nZeile: ' + lineNumber + 
             '\nSpalte: ' + column + 
             '\nStackTrace: ' +  errorObj
);

Fehler: SyntaxError: missing ; after for-loop initializer
Script: https://www.mediaevent.de/javascript/myerrorscript.js
Zeile: 6
Spalte: 12
StackTrace: SyntaxError: missing ; after for-loop initializer

Syntaxfehler

Bei Syntaxfehlern wird das Script nicht ausgeführt und die Fehlerursache erscheint in der Browser-Konsole unter den Entwickler-Werkzeugen der Browser. Allerdings beobachten die Browser das Laden externer Ressourcen, seien es nun Scripte, iframe-Elemente, PDF-Dokumente oder Bilder mit zwei Events:

• onload – Laden erfolgreich,
• onerror – Fehler sind aufgetreten

Fehlendes Bild / nicht unterstütztes Dateiformat mit onerror erkennen

Ein fehlendes Bild oder ein Bildformat, das vom Browser nicht unterstützt wird, erkennen alle Browser. Wichtig ist, dass beim Prüfen auf fehlende Bilder / nicht unterstützte Dateiformate onerror erst aufgerufen wird, wenn das img-Element bereits im HTML geladen ist.

const images = document.querySelectorAll("img");
const missing = [];
document.querySelector (".report").innerHTML = `${images.length} img-Element(e) im Dokument`;

for (const item of images) {
	const img = new Image();
	img.src = item.src;

	img.onerror = function (evt) {
		document.querySelector (".report").innerHTML += `${this.src} nicht geladen`;
		missing.push (item.getAttribute ("src"));
	}
	
	img.onload = function (evt) {
		document.querySelector (".report").innerHTML += `${this.src} geladen`;
	}
}

onerror Attribute

message

Fehlermeldung als Text

filename

Speicherort und URL zur Scriptdatei

lineno

Zeilennummer

colno

Spaltennummer

error

Das Objekt, das den Fehler verursacht

Informationen zum event

target

Das Objekt, zu dem das Ereignis ursprünglich gesendet wurde

eventPhase

Phase, in der das Ereignis bearbeitet wird: AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE

bubbles

true, wenn das Ereignis nach oben steigen kann

cancelable

Nein

timeStamp

Zeitpunkt in Millisekunden, zu dem das Ereignis eingetreten ist

onabort: Abbruch beim Laden

Event für img, video, object, audio, embed

onabort tritt ein, wenn der Benutzer das Laden einer Seite, eines Videos oder Bildes mit dem Stop-Button des Browsers oder durch Klicken eines Links abbricht.

<video controls id="gizmo">
   …
</video>

<script>
let gizmo = document.getElementById("gizmo");
gizmo.onabort = function() {
	alert('Laden des Videos abgebrochen')
}
</script>

onabort Attribute

target

Objekt zu dem das Ereignis ursprünglich gesendet wurde

cancelable

Nein/dd>

timeStamp

Zeit in Millisekunden, zu der das Ereignis eingetreten ist