AggregateError
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
* Some parts of this feature may have varying levels of support.
AggregateError オブジェクトは、複数のエラーを 1 つのエラーにまとめる必要があるときのエラーを表します。これは一つの操作で複数のエラーを報告する必要があるときに発生します。例えば Promise.any() において、渡されたすべてのプロミスが拒否された場合などです。
コンストラクター
AggregateError()新しい
AggregateErrorオブジェクトを生成します。
インスタンスプロパティ
AggregateError.prototype.messageエラーメッセージで、既定値は
""です。AggregateError.prototype.nameエラー名で、既定値は
AggregateErrorです。AggregateError:errorsAggregateErrorのインスタンスが作成された反復可能オブジェクトを本質的に反映した配列です。例えば、AggregateErrorがAggregateError()コンストラクターを用いて生成された場合、最初の引数として渡された反復可能オブジェクトから生成される配列になります。
例
AggregateError の捕捉
js
Promise.any([Promise.reject(new Error("some error"))]).catch((e) => { console.log(e instanceof AggregateError); // true console.log(e.message); // "All Promises rejected" console.log(e.name); // "AggregateError" console.log(e.errors); // [ Error: "some error" ] }); AggregateError の生成
js
try { throw new AggregateError([new Error("some error")], "Hello"); } catch (e) { console.log(e instanceof AggregateError); // true console.log(e.message); // "Hello" console.log(e.name); // "AggregateError" console.log(e.errors); // [ Error: "some error" ] } 仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-aggregate-error-objects |
