Skip to content

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 触发,你得到超时错误。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表