Diecause Dateneigenschaft einerError-Instanz gibt den spezifischen ursprünglichen Grund des Fehlers an.

Sie wird verwendet, wenn ein Fehler abgefangen und mit einer spezifischeren oder nützlicheren Fehlermeldung erneut ausgelöst wird, um dennoch Zugriff auf den ursprünglichen Fehler zu haben.

Wert

Der Wert, der demError()-Konstruktor imoptions.cause-Argument übergeben wurde. Er ist möglicherweise nicht vorhanden.

Beschreibung

Der Wert voncause kann jeden Typ haben. Sie sollten nicht davon ausgehen, dass der von Ihnen abgefangene Fehler einError alscause hat, ebenso wie Sie nicht sicher sein können, dass die imcatch-Statement gebundene Variable einError ist. Das Beispiel „Bereitstellung strukturierter Daten als Fehlerursache“ unten zeigt einen Fall, in dem absichtlich kein Fehler als Ursache angegeben wird.

Beispiele

Einen Fehler mit Ursache erneut werfen

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

try {  connectToDatabase();} catch (err) {  throw new Error("Connecting to database failed.", { cause: err });}

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

Strukturierte Daten als Fehlerursache bereitstellen

Fehlermeldungen, die für Menschen geschrieben sind, können für die maschinelle Analyse ungeeignet sein — da sie umformuliert oder geändert werden können, was bestehende Analysen, die sie verwenden, beeinträchtigen könnte. Wenn Sie einen Fehler von einer Funktion werfen, können Sie als Alternative zu einer lesbaren Fehlermeldung die Ursache als strukturierte Daten für die maschinelle Verarbeitung bereitstellen.

function makeRSA(p, q) {  if (!Number.isInteger(p) || !Number.isInteger(q)) {    throw new Error("RSA key generation requires integer inputs.", {      cause: { code: "NonInteger", values: [p, q] },    });  }  if (!areCoprime(p, q)) {    throw new Error("RSA key generation requires two co-prime integers.", {      cause: { code: "NonCoprime", values: [p, q] },    });  }  // rsa algorithm…}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Error.prototype.message
• Error.prototype.toString()