Promise.race
一句话解释
Promise.race 接收 promise 可迭代对象,在首个落定时即落定(解析或拒绝)。
用大白话说
Promise.race 运行多个 promise,在首个落定时即落定——采纳首个 promise 的完成值或拒绝原因。其余 promise 继续运行但结果被忽略。这适合超时:把真实操作与定时 promise 竞速,谁先完成谁胜。若定时胜,视为超时。Promise.race 也用于"首个成功来源"模式——查询多个缓存,用最先响应的。注意"竞速"指首个落定,而非首个解析。若首个落定的 promise 拒绝,Promise.race 拒绝,即使另一个会解析。"首个解析、忽略拒绝"用 Promise.any。非首的 promise 不会被取消——JavaScript promise 无法取消——只是不被观察。
示例
javascript
function withTimeout(promise, ms) {
const timeout = new Promise((_, reject) =>
setTimeout(() => reject(new Error("timeout")), ms)
);
return Promise.race([promise, timeout]);
}
// Resolves if fetch finishes in 5s, otherwise rejects with "timeout"
const result = await withTimeout(fetch("/api/slow"), 5000);Promise.race 以先落定者为准。若定时先于 fetch 触发,你得到超时错误。
相关术语
相关资源
相关课程
- Promise
学习 Promise.race。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。