Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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

message Optional

Eine für Menschen lesbare Beschreibung des Fehlers.

options Optional

Ein Objekt mit den folgenden Eigenschaften:

cause Optional

Ein Wert, der die konkrete Ursache des Fehlers angibt und in der Eigenschaft cause gespeichert 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.

fileName Optional

Der Pfad zur Datei, in der der Fehler aufgetreten ist. Er wird in der Eigenschaft fileName gespeichert. Der Standardwert ist der Name der Datei mit dem Code, der den Error()-Konstruktor aufgerufen hat.

lineNumber Optional

Die Zeilennummer innerhalb der Datei, in der der Fehler aufgetreten ist. Sie wird in der Eigenschaft lineNumber gespeichert. Der Standardwert ist die Zeilennummer des Aufrufs des Error()-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.

js
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.

js
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.

js
// 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

Browser-Kompatibilität

Siehe auch