Promise.race() 第一个完成

最后更新：2026-09-09

Promise.race 接收 Promise 数组，返回第一个**结束**的 Promise 的结果（无论成功或失败）。

分类	异步
ES 版本	ES6

📝 语法

Promise.race([p1, p2]).then((第一个结果) => {...});

iterable	Promise 的可迭代对象。

返回值：第一个结束的 Promise 的结果。

是否修改原值：否（返回新值）

编辑下方代码，点击运行，在输出面板查看结果：

运行结果：

（fetch 结果或超时错误）

💡 提示 race 最常用于超时控制——把请求和一个定时 reject 的 Promise 放在一起 race。

ℹ️ info 第一个结束的即使是 reject，race 也立即 reject。

浏览器	Chrome	Edge	Firefox	Safari	Opera
Promise.race()	✓ v32	✓ v12	✓ v27	✓ v8	✓ v19
所有现代浏览器均支持

更多实战案例即将上线，敬请期待。

Qrace 和 all 的区别？

Arace 取第一个完成的；all 等全部完成。

Qrace 能用于超时吗？

A能——把请求和定时 reject 的 Promise 放一起。

Qrace 的结果是什么类型？

A第一个结束的 Promise 的值——可能是成功值也可能是错误。

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。