DerError() Konstruktor erstelltError Objekte.

Syntax

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)

Parameter

messageOptional

Eine lesbare Beschreibung des Fehlers.

optionsOptional

Ein Objekt mit den folgenden Eigenschaften:

causeOptional

Ein Wert, der die spezifische Ursache des Fehlers angibt, reflektiert in dercause Eigenschaft. Wenn ein Fehler abgefangen und mit einer spezifischeren oder nützlicheren Fehlermeldung erneut geworfen wird, kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler weiterzugeben.

fileNameOptionalNicht standardisiert

Der Pfad zu der Datei, die diesen Fehler ausgelöst hat, reflektiert in derfileName Eigenschaft. Standardmäßig ist dies der Name der Datei, die denError() Konstruktor aufgerufen hat.

lineNumberOptionalNicht standardisiert

Die Zeilennummer innerhalb der Datei, in der der Fehler ausgelöst wurde, reflektiert in derlineNumber Eigenschaft. Standardmäßig ist dies die Zeilennummer, die denError() Konstruktor aufruft.

Beispiele

Funktionsaufruf oder neue Konstruktion

WennError wie eine Funktion genutzt wird, also ohnenew, wird einError-Objekt zurückgegeben.Daher wird ein einfacher Aufruf vonError dasselbe Ergebnis liefern, das man durch die Konstruktion einesError-Objekts über dasnew Schlüsselwort erzielt.

const x = Error("I was created using a function call!");// above has the same functionality as followingconst y = new Error('I was constructed via the "new" keyword!');

Einen Fehler mit einer Ursache erneut werfen

Es ist manchmal nützlich, einen Fehler abzufangen und ihn mit einer neuen Nachricht erneut zu werfen.In diesem Fall sollten Sie den ursprünglichen Fehler in den Konstruktor für den neuenError übergeben, wie gezeigt.

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

Für ein detaillierteres Beispiel sieheError > Unterschiede zwischen ähnlichen Fehlern.

Weglassen des Optionsarguments

JavaScript versucht nur,options.cause zu lesen, wennoptions ein Objekt ist — dies vermeidet eine Mehrdeutigkeit mit der anderen, nicht standardmäßigenError(message, fileName, lineNumber) Signatur, die erfordert, dass der zweite Parameter ein String ist. Wenn Sieoptions weglassen, einen primitiven Wert alsoptions übergeben oder ein Objekt ohne diecause Eigenschaft übergeben, wird das erstellteError-Objekt keinecause Eigenschaft haben.

// Omitting optionsconst error1 = new Error("Error message");console.log("cause" in error1); // false// Passing a primitive valueconst error2 = new Error("Error message", "");console.log("cause" in error2); // false// Passing an object without a cause propertyconst error3 = new Error("Error message", { details: "http error" });console.log("cause" in error3); // false

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill vonError mitcause Unterstützung incore-js
• es-shims polyfill für Errorcause
• throw
• try...catch
• Error Ursachen auf v8.dev (2021)