CKTIS / JavaScript
Error.message — der Text der Fehlermeldung
Die message-Eigenschaft einer Error-Instanz enthält den Meldungstext ohne den Fehlernamen. Erfahre, worin sich error.message und error.toString() unterscheiden und was geschieht, wenn die Meldung weggelassen wird.
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
const error = new Error(message);
error.messageError.message bezeichnet hier die message-Eigenschaft einer Fehlerinstanz, auf die mit error.message zugegriffen wird, und keine statische Eigenschaft des Error-Konstruktors. Sie gehört zu ECMAScript, nicht zu einer Web-API.
Wird new Error(message) mit einem Argument aufgerufen, das nicht undefined ist, wendet der Konstruktor die Operation ToString an. Nur wenn die Umwandlung gelingt, speichert er das Ergebnis in einer eigenen, nicht aufzählbaren message-Eigenschaft, die beschreibbar und konfigurierbar ist. Beispielsweise löst new Error(Symbol()) bei der Umwandlung einen TypeError aus, sodass der Aufruf keine Instanz zurückgibt. Wird das Argument weggelassen oder ist es undefined, erstellt der Konstruktor keine eigene message-Eigenschaft. Bei unverändertem Prototyp liefert das Auslesen die geerbte Error.prototype.message-Eigenschaft, deren Anfangswert der leere String "" ist.
error.message enthält nur die Meldung. Im Gegensatz dazu verbindet error.toString() bei einem gewöhnlichen Error mit einer nicht leeren Meldung den Namen und die Meldung zu Error: Invalid input. Ist die Meldung leer, wird nur der Name Error zurückgegeben.
Gib für vorhersagbare Beispiele eine eigene Meldung an, wie unten. Mache die Programmlogik nicht vom genauen Wortlaut der von der JavaScript-Engine erzeugten Meldungen abhängig: Ihr Text kann sich zwischen Implementierungen unterscheiden.
Beispiele
const error = new Error("Invalid input");
console.log(error.message);
console.log(error.toString());
console.log(JSON.stringify(new Error().message));Ergebnis
Invalid input Error: 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.