Window: error Event
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Das error
-Ereignis wird auf einem Window
-Objekt ausgelöst, wenn eine Ressource nicht geladen oder verwendet werden konnte – beispielsweise wenn ein Skript einen Ausführungsfehler hat.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("error", (event) => {});
onerror = (message, source, lineno, colno, error) => {};
Hinweis: Aus historischen Gründen ist onerror
bei Window
- und WorkerGlobalScope
-Objekten die einzige Ereignishandler-Eigenschaft, die mehr als ein Argument erhält.
Ereignistyp
Das Ereignisobjekt ist eine Instanz von ErrorEvent
, wenn es von einem Benutzeroberflächenelement generiert wurde, oder eine Instanz von Event
sonst.
Beschreibung
Ereignishandler-Eigenschaft
Aus historischen Gründen zeigt die onerror
-Ereignishandler-Eigenschaft bei Window
- und WorkerGlobalScope
-Objekten nur ein anderes Verhalten als andere Ereignishandler-Eigenschaften.
Beachten Sie, dass dies nur für Handler gilt, die onerror
zugewiesen sind, nicht für Handler, die mit addEventListener()
hinzugefügt wurden.
Stornierung
Die meisten Ereignishandler, die Ereignishandler-Eigenschaften zugewiesen sind, können das Standardverhalten des Ereignisses durch Rückgabe von false
aus dem Handler abbrechen:
textarea.onkeydown = () => false;
Um jedoch das Standardverhalten des error
-Ereignisses von Window
abzubrechen, muss die Ereignishandler-Eigenschaft stattdessen true
zurückgeben:
window.onerror = () => true;
Wenn es abgebrochen wird, erscheint der Fehler nicht in der Konsole, aber das aktuelle Skript wird weiterhin gestoppt.
Argumente
Die Signatur des Ereignishandlers ist asymmetrisch zwischen addEventListener()
und onerror
. Der Ereignishandler, der an Window.addEventListener()
übergeben wird, erhält ein einzelnes ErrorEvent
-Objekt, während der onerror
-Handler fünf Argumente erhält, die den Eigenschaften des ErrorEvent
-Objekts entsprechen:
message
-
Ein String, der eine menschenlesbare Fehlermeldung enthält, die das Problem beschreibt. Entspricht
ErrorEvent.message
.Hinweis: In HTML wird das Attribut des Inhaltseventhandlers
onerror
am<body>
-Element verwendet, umerror
-Ereignislistener anwindow
anzuhängen (nicht das<body>
-Element). Für diesen Ereignishandler wird der erste Parameterevent
genannt, nichtmessage
, obwohl er immer noch einen String enthält; das heißt, Sie würden<body onerror="console.error(event)">
verwenden, um die Fehlermeldung zu protokollieren. source
-
Ein String, der die URL des Skripts enthält, das den Fehler generiert hat.
lineno
-
Eine Ganzzahl, die die Zeilennummer der Skriptdatei enthält, in der der Fehler aufgetreten ist.
colno
-
Eine Ganzzahl, die die Spaltennummer der Skriptdatei enthält, in der der Fehler aufgetreten ist.
error
-
Der auszulösende Fehler. In der Regel ein
Error
-Objekt.
window.onerror = (a, b, c, d, e) => {
console.log(`message: ${a}`);
console.log(`source: ${b}`);
console.log(`lineno: ${c}`);
console.log(`colno: ${d}`);
console.log(`error: ${e}`);
return true;
};
Hinweis: Diese Parameternamen sind bei einem HTML-Eventhandler-Attribut beobachtbar, wobei der erste Parameter event
statt message
genannt wird.
Dieses spezielle Verhalten tritt nur beim onerror
-Ereignishandler bei window
auf. Der Element.onerror
Handler erhält weiterhin ein einzelnes ErrorEvent
-Objekt.
Beispiele
Live-Beispiel
HTML
<div class="controls">
<button id="script-error" type="button">Generate script error</button>
<img class="bad-img" />
</div>
<div class="event-log">
<label for="eventLog">Event log:</label>
<textarea
readonly
class="event-log-contents"
rows="8"
cols="30"
id="eventLog"></textarea>
</div>
JavaScript
const log = document.querySelector(".event-log-contents");
window.addEventListener("error", (event) => {
log.textContent = `${log.textContent}${event.type}: ${event.message}\n`;
console.log(event);
});
const scriptError = document.querySelector("#script-error");
scriptError.addEventListener("click", () => {
const badCode = "const s;";
eval(badCode);
});
Ergebnis
Spezifikationen
Specification |
---|
HTML Standard # event-error |
HTML Standard # handler-onerror |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Dieses Ereignis bei
Element
-Zielen:error
Ereignis