WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Fehlernamen: Error.prototype.name

Die name-Eigenschaft eines Fehlerobjekts beschreibt seine Kategorie, etwa Error oder TypeError. Sie lässt sich überschreiben, doch dadurch ändern sich weder der Typ des Objekts noch seine Prototypkette.

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

error.name
error.name = "CustomError"

Der Eintrag Error.name bezieht sich hier auf den Namen einer Fehlerinstanz: Er wird als error.name gelesen. Die Eigenschaft ist auf Error.prototype mit dem Anfangswert "Error" definiert. Typen wie TypeError stellen auf ihren Prototypen eigene Namen bereit. Der wörtliche Ausdruck Error.name liest dagegen den Namen der Konstruktorfunktion aus – eine andere Eigenschaft.

name kennzeichnet die Kategorie, während message das konkrete Problem beschreibt. Error.prototype.toString() verwendet beide Eigenschaften; wenn beide nicht leere Zeichenfolgen sind, lautet das Ergebnis "name: message".

Error.prototype.name ist schreibbar, nicht aufzählbar und konfigurierbar. Die Zuweisung error.name = "ValidationError" an eine gewöhnliche Instanz erzeugt eine eigene Eigenschaft. Sie erzeugt weder einen neuen Fehlertyp noch ändert sie die Prototypkette: Für das Objekt gilt weiterhin error instanceof Error. Der Name allein beweist daher nicht den Typ eines Objekts.

Beispiele

const error = new Error("Invalid input");
console.log(error.name);
error.name = "ValidationError";
console.log(error.name);
console.log(error.message);
console.log(error.toString());
console.log(error instanceof Error);

Ergebnis

Error
ValidationError
Invalid input
ValidationError: Invalid input
true

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