Error: cause

Der Wert, der dem Error()-Konstruktor im options.cause-Argument übergeben wurde. Er ist möglicherweise nicht vorhanden.

Der Wert von cause kann jeden Typ haben. Sie sollten nicht davon ausgehen, dass der abgefangene Fehler ein Error als cause hat, genauso wenig wie Sie sicherstellen können, dass die im catch-Statement gebundene Variable ein Error ist. Das Beispiel "Bereitstellung strukturierter Daten als Fehlerursache" unten zeigt einen Fall, in dem absichtlich kein Fehler als Ursache angegeben wird.

Es kann manchmal nützlich sein, einen Fehler abzufangen und ihn mit einer neuen Nachricht erneut auszulösen. In diesem Fall sollten Sie den ursprünglichen Fehler im Konstruktor für den neuen Error übergeben, wie gezeigt.

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

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

Fehlermeldungen, die für den menschlichen Konsum geschrieben wurden, können für die maschinelle Verarbeitung ungeeignet sein — da sie möglicherweise umformuliert oder interpunktiert geändert werden, was bestehendes Parsing, das für deren Verarbeitung geschrieben wurde, möglicherweise ungültig macht. Wenn Sie also einen Fehler aus einer Funktion auslösen, können Sie anstelle einer für Menschen 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…
}

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