AggregateError
一句话解释
AggregateError 是 Error 子类,持有多个错误的数组,由 Promise.any 在全部拒绝时使用。
用大白话说
AggregateError 是内置 Error 子类,把多个错误打包为一个对象。其 errors 属性是底层错误数组。它由 Promise.any 在所有输入 promise 拒绝时返回——因为 Promise.any 期望至少一个成功,全失败即聚合失败。在 AggregateError 之前,没有标准方式表示"多件事出错"。库各自发明多错误类型。AggregateError 将其标准化:当你需要一次抛出多个错误时,也可直接用 new AggregateError(errors, message) 构造。用于校验多个字段(收集所有错误并抛一个 AggregateError)、运行可能全失败的并行操作,以及想报告每个问题而非仅首个时。errors 数组让调用方检视每个单独失败。
示例
javascript
// Promise.any rejects with AggregateError if ALL promises reject
async function fetchFirst(urls) {
try {
return await Promise.any(urls.map(u => fetch(u).then(r => r.json())));
} catch (e) {
if (e instanceof AggregateError) {
console.log(`All ${e.errors.length} sources failed:`);
e.errors.forEach((err, i) => console.log(` ${i}:`, err.message));
}
throw e;
}
}
// fetchFirst(["/a", "/b", "/c"]) — uses first that succeeds, or AggregateErrorPromise.any 返回首个成功结果。若全拒绝,抛出 AggregateError,其 .errors 数组持有每次拒绝。
相关术语
相关资源
相关课程
- 错误
学习 AggregateError。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。