CKTIS / JavaScript
Error: grundlegendes Ausnahmeobjekt
Error erzeugt das grundlegende Fehlerobjekt mit optionaler Nachricht und Ursache zum Werfen und Verketten von Fehlern.
Version: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2
Syntax
Error(message?, options?); new Error(message?, options?)new Error(message?, options?) erzeugt ein Fehlerobjekt; Error(...) ohne new hat denselben Effekt. Ist message nicht undefined, wird es in einen String umgewandelt und als eigene, nicht aufzählbare Eigenschaft message gespeichert. Die geerbte Eigenschaft name ist standardmäßig "Error".
Ist options ein Objekt mit Eigenschaft cause, wird deren Wert ohne Konvertierung in eine eigene, nicht aufzählbare Eigenschaft cause kopiert. So bleibt die ursprüngliche Ausnahme beim Hinzufügen von Kontext erhalten. Nachrichtenkonvertierung oder der Getter cause kann werfen. Error lässt sich ableiten; instanceof Error erkennt normale Instanzen.
stack ist eine nützliche, aber nicht standardisierte Hosterweiterung; sein Format ist nicht portabel. Für eigene Kategorien dienen Unterklassen statt Textanalyse von message. Error existiert seit ECMAScript 1, die Option cause seit ECMAScript 2022.
Beispiele
function loadConfig() {
try {
JSON.parse("{");
} catch (cause) {
throw new Error("Could not load config", {cause});
}
}
try {
loadConfig();
} catch (error) {
console.log(error.name, error.message);
console.log(error.cause instanceof SyntaxError);
console.log(Object.keys(error).join(",") || "(none)");
}
console.log(Error("plain") instanceof Error);Ergebnis
Error Could not load config true (none) true