Error() コンストラクター

message 省略可

人間が読めるエラーの説明。

options 省略可

以下のプロパティを持つオブジェクトです。

cause 省略可

エラーの具体的な原因を示す値で cause プロパティに反映されます。エラーを捕捉して、より具体的または役立つエラーメッセージとともに例外を再度発生させるとき、元のエラーを渡すためにこのプロパティを使用できます。

fileName 省略可 Non-standard

このエラーを発生させたファイルのパスで fileName プロパティに反映されます。既定では、Error() コンストラクターを呼び出したコードを含むファイルの名前です。

lineNumber 省略可 Non-standard

このエラーを発生させたファイルの行番号で fileName プロパティに反映されます。既定では、Error() コンストラクターの呼び出しを含む行番号です。

Error が関数のように使用された場合 — new がなかった場合、 Error オブジェクトを返します。したがって、 Error を呼び出すだけで Error オブジェクトを new キーワードから構築した場合と同じものを出力します。

// これは...
const x = Error("関数呼び出しによって生成されました。");

// ...これと同じ機能です。
const y = new Error('"new" キーワードによって生成されました。');

場合によっては、例外を捕捉して、新しいメッセージとともに例外を再発生させることが有用であることがあります。 その場合、元のエラーを新しい Error のコンストラクターに渡すべきです。

try {
  frameworkThatCanThrow();
} catch (err) {
  throw new Error("New error message", { cause: err });
}

より詳細な例については、 Error > 類似するエラーと区別する をご覧ください。

JavaScriptは、options がオブジェクトの場合にのみ options.cause を読み取ろうとします。これによって、非標準の（第二引数に文字列を要求する） Error(message, fileName, lineNumber) という別のシグニチャとの曖昧さを避けます。options を省略するか、プリミティブ値を options として渡すか、 cause プロパティを持たないオブジェクトを渡した場合、生成された Error オブジェクトは cause プロパティを持たないでしょう。

// optionsを省略する
const error1 = new Error("Error message");
console.log("cause" in error1); // false

// プリミティブ値を渡す
const error2 = new Error("Error message", "");
console.log("cause" in error2); // false

// causeプロパティを持たないオブジェクトを渡す
const error3 = new Error("Error message", { details: "http error" });
console.log("cause" in error3); // false

• Polyfill of Error with cause support in core-js
• throw
• try...catch
• v8.dev Error causes (2021)