Error: cause

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Die cause Daten-Eigenschaft einer Error Instanz zeigt die spezifische ursprüngliche Ursache des Fehlers an.

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

Wert

Der Wert, der dem Error() Konstruktor im options.cause Argument übergeben wurde. Er könnte eventuell nicht vorhanden sein.

Eigenschaften der Error: cause-Property
Schreibbar ja
Aufzählbar nein
Konfigurierbar ja

Beschreibung

Der Wert von cause kann von jedem Typ sein. Sie sollten nicht davon ausgehen, dass der abgefangene Fehler eine Error als cause hat, genauso wie Sie nicht sicher sein können, dass die im catch-Statement gebundene Variable ein Error ist. Das untenstehende Beispiel "Bereitstellung strukturierter Daten als Fehlerursache" zeigt einen Fall, in dem absichtlich keine Fehlermeldung als Ursache angegeben wird.

Beispiele

Einen Fehler mit einer Ursache erneut werfen

Es kann manchmal nützlich sein, 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 neuen Error übergeben, wie gezeigt.

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

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

Strukturierte Daten als Fehlerursache bereitstellen

Fehlermeldungen, die für den menschlichen Gebrauch geschrieben wurden, sind möglicherweise nicht geeignet für maschinelles Parsen — da sie umformuliert oder die Zeichensetzung geändert werden könnte, was bestehende Parsing-Mechanismen stören könnte. Daher können Sie beim Werfen eines Fehlers von einer Funktion, als Alternative zu einer für Menschen lesbaren Fehlermeldung, die Ursache als strukturierte Daten bereitstellen, um ein maschinelles Parsen zu ermöglichen.

js
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

Specification
ECMAScript Language Specification
# sec-installerrorcause

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch