Promise.race返回首个settled的Promise结果,不取消其余Promise;典型用途是超时控制,需配合AbortController避免假成功;与all、any的区别在于race以首个settled为准,无论成功或失败。

Promise.race 是一个静态方法,它接收一个 Promise 实例数组,返回一个新的 Promise。这个新 Promise 的状态**由第一个 settle(即 resolve 或 reject)的成员决定**——谁先完成,就用谁的结果或错误。
Promise.race 常见误用:以为它“取消”其他 Promise
这是最常被误解的一点:Promise.race 不会中断、终止或取消其余未完成的 Promise。它们仍在后台运行,只是你不再“监听”它们的结果了。
- 比如
Promise.race([fetch('/api'), new Promise(r => setTimeout(r, 5000))])中,如果fetch在 5 秒后才返回,但超时 Promise 先 resolve,那 race 返回的 Promise 就已 fulfilled;可fetch请求依然在发、响应依然可能到达,只是你没处理它 - 真正要做请求取消,得用
AbortController配合fetch,而不是依赖race - 如果你发现 race 后还有副作用(如重复弹窗、多次调用回调),大概率是没清理掉其他 Promise 的后续逻辑
实际可用的典型场景:超时控制
这是 Promise.race 最稳定、最无副作用的用法。它不改变原始操作,只给它加一层“时间封顶”保障。
function timeout(ms, promise) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), ms);
return Promise.race([
promise,
new Promise((_, reject) => {
controller.signal.addEventListener('abort', () => {
clearTimeout(timeoutId);
reject(new Error('Request timed out'));
});
})
]);
}
// 使用
timeout(3000, fetch('/data')).then(res => res.json()).catch(err => console.error(err));
- 注意:上面示例用了
AbortController而不是简单的new Promise(resolve => setTimeout(resolve, ms)),是为了避免“假成功”——比如超时 Promise resolve 了,但原 Promise 其实也完成了,只是你没拿到结果 - 若用纯
setTimeout构造超时 Promise,要确保它只 reject,不能 resolve,否则可能掩盖真实错误 - 超时时间设太短(如 100ms)在弱网下容易误判;设太长(如 30s)又失去意义;建议结合业务接口历史 P95 延迟来定
Promise.race 和 Promise.all、Promise.any 的关键区别
别把 race 当成“并发执行多个请求并取最快一个”的万能工具。它的行为和用途边界很明确:
1、什么是店中店?店中店是全诚商多用户版的一大特色,它既是独立的个体,又具有群集功能。我们做个例子说明:假设尊贵的您现实生活中租赁了一个店面,店面空间很大,您可以把您的店面分割成很多独立空间再向别人转租,这样您可以额外获得一部分租赁费用收入,借以减少你的个人租赁费用投入,还能起到活跃销售场所的气氛,俗话说:货卖一堆吗。你租赁的店面可以完全分割成很多空间向外转租,也可以自己保留一块空间为自己销售商品
立即学习“Java免费学习笔记(深入)”;
-
Promise.all:全部 resolve 才 resolve;任一 reject 就 reject —— 适合强一致性依赖 -
Promise.any:任一 resolve 就 resolve;全部 reject 才 reject —— 适合容错式多源查询(如查 CDN、主站、备用 API) -
Promise.race:第一个 settle 就结束(无论 resolve 还是 reject)—— 所以它既可能返回成功结果,也可能直接抛出错误,使用时必须.catch或try/catch - 如果只想取“最快的成功结果”,别用
race,改用Promise.any;race的“快”不保成功,只保“先落地”
真正要用好 Promise.race,关键是盯住那个“第一个 settle”的不可预测性——它可能是正常响应,也可能是网络中断、服务崩溃、甚至你自己写的调试 reject。别假设它一定代表“成功”。










