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.
AggregateError() 构造函数创建了一个包装了多个错误对象的单个错误对象。
语法
js
new AggregateError(errors)
new AggregateError(errors, message)
new AggregateError(errors, message, options)
AggregateError(errors)
AggregateError(errors, message)
AggregateError(errors, message, options)
备注：
调用 AggregateError() 可以使用或不使用 new，两种方法都会创建一个新的 AggregateError 实例。
参数
errors-
一系列错误对象，实际上可能不是
Error的实例。 message可选-
一个可选的对错误集合的可读描述。
options可选-
一个具有以下属性的对象：
cause可选-
表示错误的具体原因的属性。当捕捉并重新抛出一个带有更具体或有用的错误信息的错误时，这个属性可以用来传递原始错误。
示例
创建 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-constructor |