WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ErrorEvent — Fehlerbeschreibung und zugehöriger Wert

ErrorEvent ist eine Web-API-Schnittstelle, die Fehler in Skripten oder Dateien beschreibt. Die Eigenschaft message liefert eine Textbeschreibung, während error den zugehörigen JavaScript-Wert enthält – nicht unbedingt ein Error-Objekt.

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

new ErrorEvent(type, { message, error });
event.message;
event.error;

ErrorEvent steht für ein Ereignis mit Informationen zu einem Fehler in einem Skript oder einer Datei. Es erbt von Event und ist auch in Web Workers verfügbar. Es handelt sich um eine Web-API-Schnittstelle, die im HTML-Standard definiert ist, nicht um ein integriertes ECMAScript-Objekt. Dass ein Projekt Node 24 verwendet, belegt nicht, dass diese API im Browser unterstützt wird.

ErrorEvent.message ist eine schreibgeschützte Eigenschaft, die eine menschenlesbare Fehlerbeschreibung als Zeichenfolge zurückgibt. ErrorEvent.error ist ebenfalls schreibgeschützt, gibt aber den zugehörigen JavaScript-Wert zurück. Das kann ein Error oder DOMException sein, aber setze diesen Typ nicht voraus: Prüfe den Wert und seinen Typ, bevor du auf Fehlerspezifische Eigenschaften zugreifst.

Mit new ErrorEvent(type, { message, error }) lässt sich ein Ereignis mit einer separat angegebenen Beschreibung und einem Fehlerwert erstellen. event.message muss nicht mit event.error.message übereinstimmen. Das Beispiel verwendet absichtlich unterschiedliche Zeichenfolgen; der Vergleich mit === zeigt, dass error auf dasselbe Objekt wie cause verweist. Das bloße Erstellen des Ereignisses löst weder eine Ausnahme aus noch sendet es das Ereignis an Listener.

Beispiele

(() => {
  const cause = new Error("Invalid input");
  const event = new ErrorEvent("error", {
    message: "Validation failed",
    error: cause,
  });

  console.log(event.message);
  console.log(event.error === cause);
  console.log(event.error.message);
})();

Ergebnis

Validation failed
true
Invalid input

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