CKTIS / JavaScript
ErrorEvent.error und ErrorEvent.message: Fehlerwert und Fehlermeldung
`message` enthält den Diagnosetext des Ereignisses, `error` den zugehörigen JavaScript-Wert. Dieser muss kein `Error`-Objekt sein.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
new ErrorEvent(type)
new ErrorEvent(type, { message, error })
event.message
event.errorErrorEvent ist eine Schnittstelle der Webplattform und kein eingebauter Typ von ECMAScript 2024. Auf einer Ereignisinstanz liefert event.message eine Zeichenkette, die das Problem beschreibt, und event.error den zugehörigen JavaScript-Wert. Beide Eigenschaften sind schreibgeschützt. error kann ein Error-Objekt, ein primitiver Wert wie 0, null oder undefined sein. Gehe nicht davon aus, dass der Wert eine eigene Meldung oder einen Stacktrace hat.
new ErrorEvent(type, options) initialisiert beide Eigenschaften unabhängig voneinander. Laut HTML-Standard ist der Standardwert für ein weggelassenes message "" und für ein weggelassenes error undefined. Ist der übergebene Wert ein Error-Objekt, gehört event.error.message zu diesem Objekt und muss nicht mit event.message übereinstimmen.
Meldet der Browser eine nicht abgefangene Skriptausnahme am Fenster, erhält ein mit window.addEventListener("error", handler) registrierter Listener genau ein ErrorEvent. Für dasselbe Ereignis erhält window.onerror fünf Positionsargumente: (message, source, lineno, colno, error). Nicht jedes error-Ereignis ist ein ErrorEvent: Schlägt das Laden einer Ressource an einem Element fehl, sind diese Eigenschaften nicht garantiert. Der Browser kann eine unbehandelte Promise-Ablehnung über das separate Ereignis unhandledrejection mit der Eigenschaft reason melden. Er löst das Ereignis nicht aus, wenn Fehler des Skripts unterdrückt werden oder die Ablehnung vor der Meldung behandelt wird.
Werden die Fehlerdetails eines klassischen Skripts unterdrückt, etwa bei einem ohne CORS geladenen Skript von einem anderen Origin, enthält der Bericht "Script error." als message und null als error. Verwende den Meldungstext zur Diagnose, nicht als stabilen Fehlercode. Prüfe außerhalb des Browsers, ob die Laufzeitumgebung ErrorEvent bereitstellt.
Beispiele
{
// Use the native constructor when available; otherwise model only these two properties.
const ErrorEvent = globalThis.ErrorEvent ?? class extends Event {
#message;
#error;
constructor(type, { message = "", error } = {}) {
super(type);
this.#message = String(message);
this.#error = error;
}
get message() { return this.#message; }
get error() { return this.#error; }
};
const original = new Error("Invalid input");
const event = new ErrorEvent("error", {
message: "Validation failed",
error: original,
});
console.log(event.message);
console.log(event.error === original);
console.log(event.error.message);
}Ergebnis
Validation failed true Invalid input
Führe den Code in Node.js 24 oder in der Browserkonsole aus. Ist kein natives `ErrorEvent` verfügbar, verwendet das Beispiel einen lokalen Ersatz, der nur die beiden gezeigten Eigenschaften nachbildet. Der Code erzeugt ein synthetisches Ereignis, ohne eine Ausnahme auszulösen oder das Ereignis zu versenden. `true` bestätigt die Objektidentität; die erste und die letzte Zeile zeigen unterschiedliche Meldungen.
Zugehörige Lektionen
- JavaScript · Lektion 23 · Fortgeschritten · Version: 4