Error() Konstruktor

new Error()
new Error(message)
new Error(message, options)
new Error(message, fileName)
new Error(message, fileName, lineNumber)

Error()
Error(message)
Error(message, options)
Error(message, fileName)
Error(message, fileName, lineNumber)

Note: Error() kann mit oder ohne new aufgerufen werden. Beide Aufrufarten erstellen eine neue Error-Instanz.

message Optional

Eine menschenlesbare Beschreibung des Fehlers.

options Optional

Ein Objekt mit den folgenden Eigenschaften:

cause Optional

Ein Wert, der die spezifische Ursache des Fehlers angibt, widergespiegelt in der cause-Eigenschaft. Beim Abfangen und erneuten Auslösen eines Fehlers mit einer spezifischeren oder nützlicheren Fehlermeldung kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler zu übergeben.

fileName Optional Nicht standardisiert

Der Pfad zur Datei, die diesen Fehler verursacht hat, widergespiegelt in der fileName-Eigenschaft. Standardmäßig ist dies der Name der Datei, die den Error()-Konstruktor aufgerufen hat.

lineNumber Optional Nicht standardisiert

Die Zeilennummer innerhalb der Datei, in der der Fehler aufgetreten ist, widergespiegelt in der lineNumber-Eigenschaft. Standardmäßig ist dies die Zeilennummer, die den Error()-Konstruktor aufruft.

Wenn Error wie eine Funktion verwendet wird, also ohne new, wird ein Error-Objekt zurückgegeben. Ein einfacher Aufruf von Error erzeugt daher dieselbe Ausgabe, die das Erstellen eines Error-Objekts mit dem new-Schlüsselwort erzeugen würde.

const x = Error("I was created using a function call!");

// above has the same functionality as following
const y = new Error('I was constructed via the "new" keyword!');

Es ist manchmal nützlich, einen Fehler abzufangen und diesen mit einer neuen Nachricht erneut auszulösen. In diesem Fall sollten Sie den ursprünglichen Fehler in den Konstruktor des neuen Error übergeben, wie gezeigt.

try {
  frameworkThatCanThrow();
} catch (err) {
  throw new Error("New error message", { cause: err });
}

Für ein detaillierteres Beispiel siehe Error > Zwischen ähnlichen Fehlern unterscheiden.

JavaScript versucht nur options.cause zu lesen, wenn options ein Objekt ist — dies vermeidet Mehrdeutigkeit mit der anderen nicht standardmäßigen Error(message, fileName, lineNumber)-Signatur, die als zweiten Parameter eine Zeichenkette erfordert. Wenn Sie options weglassen, einen primitiven Wert als options übergeben oder ein Objekt ohne die cause-Eigenschaft übergeben, dann wird das erstellte Error-Objekt keine cause-Eigenschaft haben.

// Omitting options
const error1 = new Error("Error message");
console.log("cause" in error1); // false

// Passing a primitive value
const error2 = new Error("Error message", "");
console.log("cause" in error2); // false

// Passing an object without a cause property
const error3 = new Error("Error message", { details: "http error" });
console.log("cause" in error3); // false

• Polyfill von Error mit cause-Unterstützung in core-js
• es-shims polyfill von Error cause
• throw
• try...catch
• Error-Ursachen auf v8.dev (2021)