【Node.js24.x】SuppressedError::SuppressedError()関数の使い方

SuppressedError関数は、複数のエラーが同時に発生する状況において、ある主要なエラーが別の二次的なエラーによって「抑制された」状態を表現するための特別なエラーオブジェクトを生成する関数です。この機能は、特に非同期処理におけるリソースの解放やクリーンアップといった二次的な処理中に新たなエラーが発生し、その結果として元々発生していた主要なエラーが見過ごされてしまうことを防ぐ目的で導入されました。

この関数はコンストラクタとして使用され、主要なエラー、それを抑制したエラー、そして任意のエラーメッセージを引数として受け取ります。生成されるSuppressedErrorオブジェクトは、errorプロパティを通じて主要なエラーにアクセスでき、suppressedプロパティを通じてその主要なエラーを抑制した二次的なエラーにアクセスできる構造を持っています。これにより、問題発生時に本来の原因となったエラーと、クリーンアップ中に発生したエラーの両方を失うことなく、詳細な情報を取得することが可能になります。

SuppressedErrorは標準のErrorクラスを継承しており、通常の例外処理メカニズムであるtry...catch構文などを用いて適切に扱うことができます。例えば、データベース接続の終了処理でエラーが起きた際に、元々発生していたSQL実行エラーの詳細が隠蔽されることなく、両方のエラーをデバッグに活用するような場面で非常に有効です。システムエンジニアにとって、複雑なエラーシナリオにおけるデバッグ効率と問題特定能力を向上させるための重要なツールとなります。

Copy
1// 抑制されたエラーのリスト
2const suppressedErrors = [
3  new Error('リソースAのクリーンアップに失敗しました。'),
4  new Error('リソースBのシャットダウンに失敗しました。')
5];
6
7// このエラーの根本原因となる主要なエラー
8const primaryError = new Error('メインの処理が期待通りに完了しませんでした。');
9
10// SuppressedError コンストラクタを使って新しいエラーを生成します。
11// 構文: new SuppressedError(errors, message[, options])
12// ここで errors は抑制されたエラーのiterable (例: 配列)、message はエラーの説明文字列、
13// options はオプションオブジェクトで、通常 { cause: primaryError } のように根本原因を指定します。
14const finalError = new SuppressedError(
15  suppressedErrors,
16  'アプリケーションの実行中に複数の問題が発生しました。',
17  { cause: primaryError }
18);
19
20// 例として、このエラーをthrowすることで、コールスタックに記録されます。
21throw finalError;

error, suppressed, message, options

• error: Error: 現在のスレッドで発生したエラーオブジェクト
• suppressed: Error: 現在のスレッドで抑制されたエラーオブジェクト
• message: string: SuppressedError を表すエラーメッセージ
• options: object: SuppressedError を設定するためのオプションオブジェクト

SuppressedError

SuppressedErrorクラスのコンストラクタです。エラーが抑制されたことを示す新しいSuppressedErrorインスタンスを生成します。