什么是 Promise.all？
promise.all 是 javascript promise 对象的一个静态方法，旨在帮助开发者并行处理多个异步操作，并在所有操作都成功完成后聚合它们的结果。它接收一个可迭代的 promise 对象（通常是一个 promise 数组）作为输入，并返回一个新的单一 promise。
根据 MDN 文档的定义，Promise.all() 返回的 Promise 具备以下特性：
- 解决条件：当且仅当所有输入的 Promise 都成功解决时，Promise.all 返回的 Promise 才会解决。
- 解决值：解决时，它会返回一个数组，该数组包含了所有输入 Promise 的解决值，并且这些值的顺序与原始输入 Promise 数组的顺序严格一致。
- 拒绝条件：如果输入 Promise 数组中的任何一个 Promise 拒绝（即失败），Promise.all 返回的 Promise 会立即拒绝，并返回第一个拒绝的原因。即使其他 Promise 仍在执行，Promise.all 也不会等待它们完成。
Promise.all 的工作原理与常见误解
为了更好地理解 Promise.all 的行为，我们首先定义一个简单的异步工具函数 timeOut，它返回一个在指定时间后解决的 Promise：
const timeOut = (t) => {
return new Promise((resolve, reject) => {
setTimeout(() => {
resolve(`Completed in ${t}`);
}, t);
});
};考虑以下代码片段，它展示了 Promise.all 和独立 Promise 链的混合使用：
// 独立的 Promise 链 timeOut(1000) .then(result => console.log(result)); // 输出: Completed in 1000 (大约在 1000ms 后) // 使用 Promise.all Promise.all([timeOut(1000), timeOut(2000), timeOut(2000)]) .then(result => console.log(result)); // 输出: ['Completed in 1000', 'Completed in 2000', 'Completed in 2000'] (大约在 2000ms 后)
许多开发者可能会预期输出是按顺序打印每个 timeOut 的完成信息，然后是 Promise.all 的结果数组，例如：
立即学习“Java免费学习笔记（深入）”；
Completed in 1000 Completed in 2000 Completed in 2000 ['Completed in 1000', 'Completed in 2000', 'Completed in 2000']
然而，实际的输出通常是：
websenB2B是一套经过完善设计的B2B行业网站程序，是windows nt系列环境下最佳的B2B行业网产站解决方案。精心设计的架构与功能机制，适合从个人到企业各方面应用的要求，为您提供一个安全、稳定、高效、易用而快捷的行业网站商务系统。分普及版和商业版等不同版本。一、网胜B2B电子商务系统SP6.2蓝色风格普及版本升级功能说明：1、邮件群发功能：可以选择某一级别的会员，并放入支持html
Completed in 1000 ['Completed in 1000', 'Completed in 2000', 'Completed in 2000']
这种差异是由于对 Promise.all 行为的误解造成的。关键在于 console.log 的位置以及 Promise 链的独立性：
独立 Promise 链的行为： timeOut(1000).then(result => console.log(result)) 是一个独立的 Promise 链。它会在大约 1000 毫秒后解决，并立即执行其 .then() 回调，打印出 Completed in 1000。
-
Promise.all 的聚合行为： Promise.all([timeOut(1000), timeOut(2000), timeOut(2000)]) 会并行启动内部的三个 timeOut Promise。
- 第一个 timeOut(1000) 会在 1000 毫秒后解决。
- 第二个和第三个 timeOut(2000) 会在 2000 毫秒后解决。 Promise.all 返回的 Promise 会等待所有这三个内部 Promise 都解决。这意味着它会等待最慢的 Promise 完成，即 2000 毫秒后。一旦所有 Promise 都解决，Promise.all 的 .then() 回调才会被触发，并打印包含所有结果的数组。
因此，Completed in 1000 的输出会在 1000 毫秒时出现，而 Promise.all 的结果数组则会在 2000 毫秒时出现。这就是为什么 Completed in 2000 没有单独打印，因为 Promise.all 自身只提供一个最终的聚合结果，它不会在内部 Promise 解决时单独触发 console.log。
正确使用 Promise.all 的姿势
如果你需要监控每个 Promise 的中间状态或单独处理它们的解决，你需要为每个 Promise 单独附加 .then()。如果你只需要所有 Promise 完成后的聚合结果，Promise.all 则是最简洁高效的选择。
以下示例展示了如何清晰地区分这两种情况：
const timeOut = (t) => {
return new Promise((resolve, reject) => {
setTimeout(() => {
// 内部日志可以帮助理解 Promise 何时解决
console.log(`[Internal] Promise for ${t}ms resolved.`);
resolve(`Completed in ${t}`);
}, t);
});
};
console.log("--- 独立 Promise 处理 ---");
// 独立处理每个 Promise，它们会按照各自的解决时间打印
timeOut(1000).then(result => console.log(`[Individual] ${result}`));
timeOut(2000).then(result => console.log(`[Individual] ${result}`));
timeOut(500).then(result => console.log(`[Individual] ${result}`));
console.log("--- Promise.all 聚合处理 ---");
// Promise.all 会等待所有 Promise 完成后，一次性打印聚合结果
Promise.all([timeOut(1000), timeOut(2000), timeOut(3000)])
.then(results => console.log(`[Promise.all] All results: ${results}`))
.catch(error => console.error(`[Promise.all] Rejected: ${error}`));
/*
预期输出顺序可能类似 (时间顺序):
[Internal] Promise for 500ms resolved.
[Individual] Completed in 500
[Internal] Promise for 1000ms resolved.
[Individual] Completed in 1000
[Internal] Promise for 1000ms resolved. (来自 Promise.all 内部的 1000ms Promise)
[Internal] Promise for 2000ms resolved.
[Individual] Completed in 2000
[Internal] Promise for 2000ms resolved. (来自 Promise.all 内部的 2000ms Promise)
[Internal] Promise for 3000ms resolved. (来自 Promise.all 内部的 3000ms Promise)
[Promise.all] All results: Completed in 1000,Completed in 2000,Completed in 3000
*/注意事项
- 结果顺序保持：Promise.all 返回的数组中的值，其顺序与传入的 Promise 数组的顺序严格一致，这与 Promise 实际解决的快慢无关。
- “失败即失败”原则：Promise.all 遵循“失败即失败”（Fail-fast）的原则。只要传入的 Promise 中有一个拒绝，Promise.all 就会立即拒绝，并返回第一个拒绝的原因。即使其他 Promise 还在执行或最终会解决，Promise.all 的状态也不会改变。
- 所有 Promise 都会执行：即使 Promise.all 因为某个 Promise 拒绝而提前拒绝，所有传入的 Promise 仍然会继续执行到它们自己的最终状态（解决或拒绝）。Promise.all 只是不再关心它们的结果。
- 空数组处理：如果 Promise.all 传入一个空数组，它会立即解决，并返回一个空数组 []。
总结
Promise.all 是处理多个并发异步操作的强大工具，它允许我们等待所有操作完成后，一次性获取它们的聚合结果。理解其核心行为，特别是它如何等待所有 Promise 解决以及如何聚合结果，对于避免常见的异步编程陷阱至关重要。通过合理地使用 Promise.all，我们可以编写出更高效、更健壮的异步 JavaScript 代码。
