SuppressedError

コンストラクター

SuppressedError()

SuppressedError オブジェクトを生成します。

インスタンスプロパティ

継承元の Error からインスタンスプロパティも継承します。

これらのプロパティは SuppressedError.prototype に定義されており、すべての SuppressedError インスタンスで共有されます。

SuppressedError.prototype.constructor

インスタンスオブジェクトを生成したコンストラクター関数。SuppressedError インスタンスの場合、初期値は SuppressedError コンストラクターです。

SuppressedError.prototype.name

エラーの種類を表す名前。SuppressedError.prototype.name の初期値は "SuppressedError" です。

これらのプロパティは各 SuppressedError インスタンスの固有のプロパティです。

error

抑制の結果としてのエラーへの参照。

suppressed

error によって抑制されたエラーへの参照。

インスタンスメソッド

親 Error からインスタンスメソッドを継承します。

例

SuppressedError のキャッチ

SuppressedError は、リソースの破棄 中にエラーが発生したときにスローされます。エラーをスローするとスコープのクリーンアップが行われ、クリーンアップ中の各 disposer は独自のエラーをスローできます。これらのエラーはすべて SuppressedError インスタンスのチェーンに収集され、元のエラーが suppressed プロパティとして、次の disposer によってスローされた新しいエラーが error プロパティとして格納されます。

try {
  using resource1 = {
    [Symbol.dispose]() {
      throw new Error("resource1 の破棄中にエラーが発生しました");
    },
  };
  using resource2 = {
    [Symbol.dispose]() {
      throw new Error("resource2 の破棄中にエラーが発生しました");
    },
  };
  throw new Error("元のエラー");
} catch (e) {
  console.log(e instanceof SuppressedError); // true
  console.log(e.message); // "破棄中にエラーが抑制されました"
  console.log(e.name); // "SuppressedError"
  console.log(e.error); // Error: resource1 の破棄中にエラーが発生しました
  console.log(e.suppressed); // SuppressedError: 破棄中にエラーが抑制されました
  console.log(e.suppressed.error); // Error: resource2 の破棄中にエラーが発生しました
  console.log(e.suppressed.suppressed); // Error: 元のエラー
}

チェーンは次のようになります：

       SuppressedError --suppressed--> SuppressedError --suppressed--> 元のエラー
              |                               |
            error                           error
              v                               v
resource1 の破棄中にエラーが発生しました   resource2 の破棄中にエラーが発生しました
    (破棄は後で行われます)                (破棄は先に行われます)

SuppressedError の作成

try {
  throw new SuppressedError(
    new Error("新しいエラー"),
    new Error("元のエラー"),
    "こんにちは",
  );
} catch (e) {
  console.log(e instanceof SuppressedError); // true
  console.log(e.message); // "こんにちは"
  console.log(e.name); // "SuppressedError"
  console.log(e.error); // Error: "新しいエラー"
  console.log(e.suppressed); // Error: "元のエラー"
}

仕様書

ブラウザーの互換性

関連情報

• core-js における SuppressedError のポリフィル
• Error
• using
• await using
• DisposableStack
• AsyncDisposableStack