使用 promise.race 结合自定义超时 promise 即可实现异步操作的超时合并分组。具体做法是创建一个包含所有目标 promise 的数组，再构造一个在指定毫秒后自动 reject 的定时器 promise，将两者传入 promise.race。若任务在时限内完成则返回结果，否则抛出超时错误。此方法适用于需要统一控制多个并发请求生命周期的场景。
Promise.race 如何拦截单个任务的执行
Promise.race 会立即启动所有传入的 Promise，并监听哪个最先改变状态。一旦某个 Promise（包括超时器）变为终态，其余未完成的 Promise 将被忽略，其后续操作不再影响主流程。这种机制天然支持超时合并，因为超时 Promise 与业务 Promise 处于同一竞争队列中。
const timeout = (ms) => new Promise((_, reject) => setTimeout(() => reject(new Error('Timeout')), ms));
async function runWithTimeout(tasks, limitMs) {
try {
return await Promise.race([...tasks, timeout(limitMs)]);
} catch (error) {
if (error.message === 'Timeout') {
console.log('Operation timed out');
} else {
throw error;
}
}
}
// 示例调用
const task1 = () => new Promise(resolve => setTimeout(() => resolve('Success'), 100));
runWithTimeout([task1()], 50).catch(console.error); // 输出: Operation timed out
如何处理超时后的资源清理或状态重置
当 Promise.race 因超时触发 catch 分支时，原始 Promise 可能仍在后台运行。虽然 JavaScript 垃圾回收机制会自动处理未引用的对象，但对于持有外部资源（如网络连接、文件句柄）的任务，建议在超时发生时显式调用取消方法。例如，对于 Fetch API，可配合 AbortController 实现真正的中断，避免无效的资源占用。
const controller = new AbortController();
const { signal } = controller;
const fetchTask = () => fetch('https://api.example.com/data', { signal });
const timeout = (ms) => new Promise((_, reject) => setTimeout(() => reject(new Error('Timeout')), ms));
async function safeRun() {
try {
return await Promise.race([fetchTask(), timeout(5000)]);
} catch (error) {
controller.abort(); // 主动取消网络请求
console.log('Aborted due to timeout');
}
}
safeRun();
基于输入参数 limitMs 为 0 时的具体行为
当传入的超时时间 limitMs 为 0 时，setTimeout 会将回调放入宏任务队列的最末端，而不会立即执行。这意味着只要当前微任务队列中有其他 Promise 解析，业务任务仍有机会先于超时器完成。只有当所有同步代码和微任务执行完毕后，超时器才会被触发，从而可能导致极短的业务逻辑也被判定为超时，这在实际开发中需特别注意时序差异。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
