promise.allsettled用于处理多个promise，无论成功或失败，都会等待全部完成并返回结果报告。1. 它接收一个promise数组，返回一个在所有promise落定后解决的新promise；2. 返回值是一个数组，每个元素包含status（'fulfilled'或'rejected'）及对应value或reason；3. 与promise.all不同，它不会因单个失败而中断；4. 适用于需要完整结果报告的场景，如批量操作、数据收集、非关键任务执行和调试分析；5. 处理结果时可通过遍历数组区分成功与失败，并进行后续操作，例如筛选数据、统一错误处理或有条件重试。
Promise.allSettled是一个非常有用的JavaScript异步操作工具，它能让你在处理一组Promise时，无论这些Promise是成功还是失败，都能等到它们全部完成，然后给你一个包含所有结果的报告。这意味着即使其中有Promise拒绝了，也不会像Promise.all那样立即中断，而是会继续等待所有操作都得出结论。
解决方案
在使用JavaScript处理多个并发异步任务时，我们常常需要等待所有任务都完成，无论它们的结果是成功还是失败。Promise.allSettled正是为这种场景而生。它接收一个Promise的可迭代对象（比如一个数组），然后返回一个新的Promise。这个新的Promise会在所有输入的Promise都“落定”（settled，即无论是fulfilled成功还是rejected失败）之后才解决。解决后的值是一个数组，数组中的每个元素都是一个对象，描述了对应Promise的最终状态。
每个结果对象都有一个status属性，可能是'fulfilled'或'rejected'。如果状态是'fulfilled'，对象会有一个value属性，包含该Promise的成功值；如果状态是'rejected'，则会有一个reason属性，包含该Promise的拒绝原因。这种设计使得我们能够清晰地知道每一个异步操作的最终结果，而不会因为某个操作的失败而丢失其他操作的信息。
举个例子，假设你要同时向多个不同的API端点发起请求，并且你希望无论哪个请求失败，都能拿到所有请求的最终状态：
const fetchUserData = () => new Promise(resolve => setTimeout(() => resolve({ id: 1, name: 'Alice' }), 1000));
const fetchProductData = () => new Promise((_, reject) => setTimeout(() => reject(new Error('Product API failed')), 1500));
const fetchOrderData = () => new Promise(resolve => setTimeout(() => resolve({ orderId: 'ABC', total: 120 }), 800));
async function getAllDataOutcomes() {
const results = await Promise.allSettled([
fetchUserData(),
fetchProductData(),
fetchOrderData()
]);
console.log(results);
// 预期输出类似：
// [
// { status: 'fulfilled', value: { id: 1, name: 'Alice' } },
// { status: 'rejected', reason: Error: Product API failed },
// { status: 'fulfilled', value: { orderId: 'ABC', total: 120 } }
// ]
results.forEach((result, index) => {
if (result.status === 'fulfilled') {
console.log(`Promise ${index + 1} succeeded with value:`, result.value);
} else {
console.error(`Promise ${index + 1} failed with reason:`, result.reason);
}
});
}
getAllDataOutcomes();这个例子清楚地展示了Promise.allSettled如何让你在所有操作完成后，统一地检查并处理每个操作的结果，无论成功与否。
Promise.allSettled与Promise.all和Promise.race有何不同？
这三者在处理Promise集合时各有侧重，理解它们的差异是掌握异步编程的关键。对我来说，最直观的区分点在于它们对“失败”的态度。
Promise.all是“全有或全无”的策略。它期望所有传入的Promise都能成功。一旦其中任何一个Promise被拒绝（rejected），Promise.all返回的Promise就会立即拒绝，并把第一个拒绝的原因作为其拒绝值。这意味着，如果你有十个并发请求，其中一个失败了，那么你根本不会知道其他九个请求是成功了还是还在进行中，因为整个Promise.all操作已经提前结束了。这在某些场景下很有用，比如你所有的操作都必须成功才能继续下一步，任何一个失败都意味着整个流程的失败。
Promise.race则像是一场赛跑。它会等待传入的Promise集合中第一个“落定”（无论是成功还是失败）的Promise。一旦有Promise成功解决了，Promise.race就成功解决；一旦有Promise拒绝了，Promise.race就立即拒绝。它只关心“最快”的结果，而不关心其他Promise的状态。这在超时控制或多个数据源竞争的场景中非常有用，比如你从多个服务器请求相同的数据，只取最快响应的那个。
而Promise.allSettled则完全不同，它有点像一个负责任的家长，会等待所有孩子（Promise）都完成各自的事情（无论是考上大学还是创业失败），然后才给你一份完整的报告。它不会因为某个Promise的失败而中断整个等待过程。它的核心价值在于“收集所有结果”，即使有些结果是错误信息。这对于需要进行完整审计、日志记录或在UI上展示所有操作状态的场景来说，简直是量身定制。比如，你批量上传文件，你可能想知道哪些文件上传成功了，哪些失败了，以及失败的原因，而不是一失败就中断整个批处理。
什么时候应该优先考虑使用Promise.allSettled？
在我的实际开发经验中，Promise.allSettled经常在那些“部分成功也算成功，但需要知道所有细节”的场景中大放异彩。它特别适合以下几种情况：
批量操作且需要完整报告：当你执行一组相互独立的任务时，比如同时更新用户配置的多个字段，或者向多个分析服务发送数据。即使其中一个操作失败了，你也不希望整个流程中断，而是想知道每个操作的具体结果，以便进行后续处理（例如，重试失败的，或给用户反馈哪些成功了，哪些失败了）。如果你用
Promise.all，一个字段更新失败就会导致整个操作失败，你无法直接获取其他字段的更新结果。数据收集与容错：假设你正在从多个不相关的API获取数据，用于填充UI的不同部分。例如，一个页面需要显示用户基本信息、订单列表和最近的活动。如果订单API暂时不可用，你仍然希望能够显示用户基本信息和活动，而不是整个页面都加载失败。使用
Promise.allSettled，你可以独立地处理每个数据源的结果，即使某个API调用失败，其他成功的数据也能正常展示。非关键性任务的并行执行：有些任务不是核心业务流程的一部分，但仍然有价值，比如日志记录、缓存更新、发送通知等。你可以将它们与核心业务逻辑并行执行，使用
Promise.allSettled来确保它们都被尝试执行，并且你可以事后检查它们的执行状态，而不会影响主流程的响应时间或稳定性。调试和错误分析：在开发或调试阶段，当你需要了解一组并发操作中每一个操作的详细情况时，
Promise.allSettled提供了非常直接的手段。它返回的结构化结果让你能够轻松地识别哪些操作成功了，哪些失败了，以及失败的具体原因，这对于定位问题非常有帮助。
简单来说，当你需要“无论如何，都要给我所有结果”的时候，Promise.allSettled就是你的首选。它提供了一种优雅的方式来处理并发任务中的部分失败，同时保持对所有任务状态的可见性。
如何处理Promise.allSettled返回的结果？
处理Promise.allSettled返回的结果，核心在于遍历那个包含状态对象的数组，并根据每个对象的status属性来区分成功和失败。
返回的数组中，每个元素都是一个形如{ status: 'fulfilled', value: any }或{ status: 'rejected', reason: any }的对象。所以，处理它的方式通常会涉及一个循环和条件判断。
async function processAllOutcomes(promises) {
const results = await Promise.allSettled(promises);
const successfulResults = [];
const failedResults = [];
results.forEach((item, index) => {
if (item.status === 'fulfilled') {
successfulResults.push({ index, value: item.value });
console.log(`操作 ${index} 成功:`, item.value);
} else {
failedResults.push({ index, reason: item.reason });
console.error(`操作 ${index} 失败:`, item.reason);
}
});
console.log('\n--- 汇总报告 ---');
if (successfulResults.length > 0) {
console.log('成功完成的操作:', successfulResults);
} else {
console.log('没有操作成功。');
}
if (failedResults.length > 0) {
console.log('失败的操作:', failedResults);
// 这里可以进一步处理失败，比如重试、记录日志或向用户显示错误消息
} else {
console.log('所有操作均成功完成！');
}
return { successfulResults, failedResults };
}
// 示例调用
const p1 = Promise.resolve('Data A');
const p2 = Promise.reject(new Error('Network Error'));
const p3 = new Promise(resolve => setTimeout(() => resolve('Data B'), 500));
processAllOutcomes([p1, p2, p3]);在这个例子中，我们迭代了results数组，并根据item.status来判断是成功还是失败。我们甚至可以进一步将成功和失败的结果分别收集起来，以便后续的批量处理。
更进一步，你可以根据业务需求，对这些结果进行复杂的后处理：
-
筛选并聚合成功数据：如果你需要从所有成功的操作中提取特定数据，可以利用
map或filter等数组方法。const fulfilledValues = results .filter(item => item.status === 'fulfilled') .map(item => item.value); console.log('所有成功获取的值:', fulfilledValues); -
统一错误处理：你可以收集所有失败的原因，然后统一上报到错误监控系统，或者在UI上显示一个包含所有错误信息的弹窗。
const rejectedReasons = results .filter(item => item.status === 'rejected') .map(item => item.reason); if (rejectedReasons.length > 0) { console.error('发现以下错误:', rejectedReasons); // 上报到Sentry或Loggly } - 有条件地重试：对于某些可重试的错误（例如网络超时），你可以在收集到所有失败结果后，只对这些特定的失败进行重试操作。
这种结果处理模式赋予了开发者极大的灵活性，能够根据实际场景，精细地控制和响应每一个异步操作的最终状态。
