AbortSignal.timeout 是现代浏览器和 Node.js（v18.17+/v20.5+）提供的原生超时机制，由运行时内核级定时器驱动，毫秒级精度触发 abort，不依赖事件循环，比 setTimeout + controller.abort() 更可靠、轻量且符合规范。
AbortSignal.timeout 是现代浏览器和 Node.js（v18.17+ / v20.5+）提供的原生超时机制，它能以系统级精度触发 abort，比手动 setTimeout + controller.abort() 更可靠、更轻量、更符合规范。关键在于它不依赖 JavaScript 事件循环的调度精度，而是由运行时底层直接集成中断信号。
为什么 timeout() 比手写 setTimeout 更精准
传统方式如 setTimeout(() => controller.abort(), ms) 受限于事件循环延迟：若主线程正执行长任务（如大数组排序、复杂渲染），setTimeout 回调可能严重滞后，导致超时失效或延迟数秒。而 AbortSignal.timeout(ms) 由运行时内核级定时器驱动，在毫秒级精度下触发 abort —— 即使 JS 线程阻塞，信号仍会准时发出（后续 abort 会在线程空闲时立即处理）。
正确用法：与 fetch、stream、Promise.race 配合
timeout() 返回的是标准 AbortSignal，可直接传给支持 signal 的异步 API：
-
fetch 请求超时：
fetch(url, { signal: AbortSignal.timeout(3000) })—— 网络层在 3s 后中止连接，不等待响应头 -
自定义 Promise 超时：
await Promise.race([myAsyncTask(), new Promise((_, rej) => setTimeout(rej, 5000))])❌ 不推荐；应改用await Promise.race([myAsyncTask(), new Promise((_, rej) => AbortSignal.timeout(5000).addEventListener('abort', () => rej(new Error('timeout'))))])✅；但更简洁的是封装工具函数 -
ReadableStream 读取超时：
const reader = stream.getReader({ signal: AbortSignal.timeout(1000) }); await reader.read();—— 读操作卡住 1s 即 abort
注意事项与常见陷阱
timeout() 创建的是**一次性信号**，不可复用；且 abort 后 signal.aborted 为 true，但不会自动清理监听器 —— 若需多次使用，每次都要新建 signal。
- Node.js 中需确保启用实验性 AbortSignal 支持（v18.17+ 默认开启，v16 不支持）
- 不支持 polyfill：无法通过第三方库模拟其系统级精度，旧环境请降级为 setTimeout + 手动检查
- 超时后 Promise 仍可能 resolve/reject，需配合 try/catch 或 .catch() 捕获 abort 错误（错误类型为
DOMException，name === 'AbortError'） - 避免在 timeout 时间极短（如
实用封装建议
为提升复用性，可封装一个类型安全的超时工具：
function withTimeout<t>(promise: Promise<t>, ms: number): Promise<t> {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), ms);
return Promise.race([
promise.finally(() => clearTimeout(timeoutId)),
new Promise<never>((_, reject) => {
controller.signal.addEventListener('abort', () => {
reject(new Error(`Operation timed out after ${ms}ms`));
}, { once: true });
})
]);
}</never></t></t></t>注意：此封装仍依赖 setTimeout 清理，仅用于兼容场景；生产环境优先直接使用 AbortSignal.timeout(ms) 并传入原生支持 signal 的 API。
