Error()-Konstruktor
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Der Error()-Konstruktor erstellt Error-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)
Hinweis:
Error() kann mit oder ohne new aufgerufen werden. In beiden Fällen wird eine neue Error-Instanz erstellt.
Parameter
messageOptional-
Eine für Menschen lesbare Beschreibung des Fehlers.
optionsOptional-
Ein Objekt mit den folgenden Eigenschaften:
causeOptional-
Ein Wert, der die konkrete Ursache des Fehlers angibt und in der Eigenschaft
causegespeichert wird. Wenn ein Fehler abgefangen und mit einer genaueren oder hilfreicheren Fehlermeldung erneut ausgelöst wird, kann über diese Eigenschaft der ursprüngliche Fehler weitergegeben werden.
fileNameOptional-
Der Pfad zur Datei, in der der Fehler aufgetreten ist. Er wird in der Eigenschaft
fileNamegespeichert. Der Standardwert ist der Name der Datei mit dem Code, der denError()-Konstruktor aufgerufen hat. lineNumberOptional-
Die Zeilennummer innerhalb der Datei, in der der Fehler aufgetreten ist. Sie wird in der Eigenschaft
lineNumbergespeichert. Der Standardwert ist die Zeilennummer des Aufrufs desError()-Konstruktors.
Beispiele
>Funktionsaufruf oder Konstruktion mit new
Wenn Error wie eine Funktion verwendet wird, also ohne new, gibt es ein Error-Objekt zurück.
Ein einfacher Aufruf von Error liefert daher dasselbe Ergebnis wie die Erstellung eines Error-Objekts mit dem Schlüsselwort new.
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!');
Erneutes Auslösen eines Fehlers mit einer Ursache
Manchmal ist es sinnvoll, einen Fehler abzufangen und mit einer neuen Meldung erneut auszulösen.
Übergeben Sie in diesem Fall den ursprünglichen Fehler an den Konstruktor des neuen Error-Objekts, wie hier gezeigt.
try {
frameworkThatCanThrow();
} catch (err) {
throw new Error("New error message", { cause: err });
}
Ein ausführlicheres Beispiel finden Sie unter Error > Ähnliche Fehler unterscheiden.
Weglassen des options-Arguments
JavaScript versucht nur dann, options.cause auszulesen, wenn options ein Objekt ist. Dadurch werden Mehrdeutigkeiten mit der anderen, nicht standardisierten Signatur Error(message, fileName, lineNumber) vermieden, bei der der zweite Parameter ein String sein muss. Wenn Sie options weglassen, einen primitiven Wert als options übergeben oder ein Objekt ohne die Eigenschaft cause übergeben, besitzt das erstellte Error-Objekt keine Eigenschaft cause.
// 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
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-error-constructor> |