【Node.js24.x】Object::SuppressedError()メソッドの使い方

SuppressedErrorメソッドは、Node.jsのObjectクラスに属する組み込みメソッドで、複数の非同期処理などが並行して実行される際に発生する複数のエラーを管理し、特に、ある主要なエラーによって別のエラーの報告や処理が「抑制」されてしまう状況下で、それら抑制されたエラーの情報を失うことなく追跡し、保持する役割を実行するメソッドです。このメソッドは、開発者が非同期処理のエラーハンドリングを行う際、予期せぬエラーが隠蔽されてしまうことを防ぎ、すべてのエラーのコンテキストを把握できるようにすることで、より堅牢なアプリケーションの構築と効率的なデバッグ作業を支援します。抑制されたエラーを適切に取得・処理することで、エラーの原因究明が容易になり、システムの安定性向上に貢献します。

Copy
1const mainFailure = new Error('主要な処理でエラーが発生しました');
2const suppressedDetail = new Error('付随するクリーンアップ処理が部分的に失敗しました');
3
4// 主要なエラーと、それに付随して発生し抑制されたエラーを指定して、新しいSuppressedErrorを作成します。
5const aggregatedError = new SuppressedError(
6  mainFailure,
7  suppressedDetail,
8  '複数のエラーが発生しました。詳細を確認してください。'
9);

error, suppressed

• error: Error: 元となったエラーオブジェクト
• suppressed: Error: 抑制されたエラーオブジェクト

SuppressedError

SuppressedErrorは、他のエラーを抑制（suppress）した際のエラー情報を保持するために使用されるクラスです。このメソッドを呼び出すと、SuppressedErrorクラスのインスタンスが生成され、エラーの連鎖を管理するために利用されます。