Promise.race 返回一个新 Promise，当输入数组中第一个 Promise 充实或拒绝时立即决议，其余结果被忽略；空数组返回永远 pending 的 Promise，非可迭代对象抛 TypeError。
Promise.race 的核心行为
Promise.race 接收一个可迭代对象（通常是数组），返回一个新的 Promise。它会在**第一个入参 Promise 状态变为 fulfilled 或 rejected 时立即决议**，结果值或错误原因就是那个最先完成的 Promise 的结果。其余 Promise 仍会继续执行，但其结果被忽略。
关键实现要点
要符合规范（如 Promises/A+ 和 ECMA-262），需注意：
- 输入必须被
Promise.resolve()包装，确保每个元素都转为 Promise（处理非 Promise 值、thenable 等） - 空数组应返回一个永远 pending 的 Promise（规范要求：不 resolve 也不 reject）
- 需正确处理异常：若遍历中某个元素调用
Promise.resolve抛错，则该错误应作为 race 返回 Promise 的 rejection 原因 - 必须异步调度回调（使用
queueMicrotask或Promise.resolve().then），保证符合 Promise 的“异步决议”语义
基础模拟实现（ES6+）
以下是一个贴近规范、无依赖的轻量实现：
function PromiseRace(iterable) {
return new Promise((resolve, reject) => {
// 处理非可迭代对象
if (typeof iterable[Symbol.iterator] !== 'function') {
return reject(new TypeError(`${iterable} is not iterable`));
}
const iter = iterable[Symbol.iterator]();
let done = false;
const error = (err) => {
if (!done) {
done = true;
reject(err);
}
};
const next = () => {
try {
const { value, done: iterDone } = iter.next();
if (iterDone) {
// 遍历结束且无 Promise 完成 → 永远 pending
return;
}
// 包装为 Promise 并监听
Promise.resolve(value).then(
(val) => {
if (!done) {
done = true;
resolve(val);
}
},
(reason) => {
if (!done) {
done = true;
reject(reason);
}
}
);
} catch (e) {
error(e);
return;
}
queueMicrotask(next);
};
queueMicrotask(next);
});
}
使用示例与验证
可以这样测试：
立即学习“Java免费学习笔记（深入）”；
// ✅ 第一个 Promise 先 fulfill
PromiseRace([Promise.delay(100, 'a'), Promise.delay(50, 'b')])
.then(console.log); // 输出 'b'
// ✅ 第一个 Promise 先 reject
PromiseRace([Promise.reject('fail'), Promise.resolve('ok')])
.catch(console.error); // 输出 'fail'
// ✅ 空数组 → pending（不会触发 then/catch）
PromiseRace([]).then(() => console.log('never')).catch(() => console.log('never'));
// ✅ 同步抛错（如传 null）
PromiseRace([null]).catch(e => console.log(e instanceof TypeError)); // true
注意：真实环境中建议直接使用原生 Promise.race；此实现主要用于理解原理和教学场景。生产代码中若需 polyfill，请优先选用成熟方案如 core-js。
