使用 promise.race 将业务逻辑与超时任务进行竞争,即可实现异步操作的超时处理。具体做法是创建一个在指定毫秒后自动拒绝的 promise,并将其与原 promise 放入 promise.race 中;一旦计时器先触发,整个竞态就会以超时错误结束,从而中断后续等待。

Promise.race 如何决定最终状态
Promise.race 接受一个可迭代对象(如数组),并返回一个新的 Promise。这个新 Promise 的状态完全取决于传入的可迭代对象中“第一个”完成(兑现或拒绝)的 Promise。如果业务代码中的异步请求比超时计时器更快完成,race 的结果就是业务请求的成功值或失败原因;反之,如果计时器先到期,race 的结果就是计时器的拒绝状态。这种机制天然适合用于拦截长时间挂起的操作。

function withTimeout(promise, ms) {
const timeout = new Promise((_, reject) => {
setTimeout(() => reject(new Error('Operation timed out')), ms);
});
return Promise.race([promise, timeout]);
}
// 使用示例
const fetchData = fetch('https://api.example.com/data');
withTimeout(fetchData, 5000)
.then(data => console.log('Success:', data))
.catch(err => console.error('Failed:', err.message));上述代码定义了一个通用的 withTimeout 辅助函数。它接收一个待处理的 Promise 和一个超时时间(毫秒)。内部创建了一个基于 setTimeout 的 Promise,该 Promise 在时间到达时调用 reject。通过 Promise.race 竞争两者,调用方只需对返回结果进行常规的 .then 和 .catch 处理即可。
立即学习“Java免费学习笔记(深入)”;
如何处理超时后的资源清理
当 Promise.race 因超时而拒绝时,原本的业务 Promise 可能仍在后台运行(例如网络请求尚未取消)。为了防止资源泄漏或无效计算,通常需要在超时发生时主动终止业务逻辑。对于支持取消的 API(如 fetch),可以结合 AbortController 来实现这一目标。

function fetchWithTimeout(url, options = {}) {
const { timeout = 5000, ...fetchOptions } = options;
const controller = new AbortController();
const signal = controller.signal;
const timeoutId = setTimeout(() => controller.abort(), timeout);
return fetch(url, { ...fetchOptions, signal })
.finally(() => clearTimeout(timeoutId));
}
// 使用示例
fetchWithTimeout('https://api.example.com/slow-endpoint', { timeout: 3000 })
.then(res => res.json())
.then(console.log)
.catch(err => {
if (err.name === 'AbortError') {
console.log('Request cancelled due to timeout');
} else {
console.error('Other error:', err);
}
});在这个增强版实现中,我们引入了 AbortController。在发起请求前设置一个定时器,一旦超时便调用 controller.abort(),这会向 fetch 发送取消信号,导致其抛出一个 AbortError。.finally() 块确保无论请求成功、失败还是被取消,定时器都会被清除,避免内存泄漏。这种方式不仅解决了超时判断问题,还彻底停止了后台的网络活动。
超时错误的具体类型与捕获方式
在使用基础 Promise.race 方案时,超时触发的拒绝是一个普通的 Error 对象,其消息通常为 'Operation timed out'。开发者可以通过检查错误对象的 message 属性或自定义错误类型来区分超时与其他业务错误。而在结合 AbortController 的方案中,超时导致的错误类型为 AbortError,这是浏览器原生提供的标准错误名,便于精确匹配。


















