AbortSignal.timeout 是浏览器和新版 Node.js 原生支持的毫秒级超时机制，通过引擎内置调度实现高精度，无需手动 AbortController；需注意版本要求、异步适用性及不可复用等限制。
AbortSignal.timeout 是现代浏览器和 Node.js（v18.17+ / v20.5+）原生支持的超时机制，它能直接生成一个在指定毫秒后自动触发 abort 的 AbortSignal，无需手动创建 AbortController 或 setTimeout。它天然具备毫秒级精度——因为底层就是基于高精度定时器（如 setTimeout 或更底层的系统时钟），且无额外封装开销。
✅ 为什么 timeout() 能做到毫秒级精度？
不同于手动用 setTimeout + abort() 组合（可能因事件循环延迟导致误差放大），AbortSignal.timeout(ms) 是运行时内置方法，由引擎直接调度。V8 和 Deno 等环境对其做了优化，实际触发时间偏差通常
✅ 基础用法：搭配 fetch 实现精准超时
这是最常见也最推荐的场景：
- 直接传入
signal: AbortSignal.timeout(800)，表示 800ms 后自动中止请求 - 若超时触发，fetch 会立即 reject 并抛出
AbortError（name 属性为 "AbortError"） - 无需 try/catch 多余 signal.abort()，也不用清理定时器
示例：
async function fetchWithTimeout(url, ms = 1000) {
try {
const res = await fetch(url, {
signal: AbortSignal.timeout(ms)
});
return await res.json();
} catch (err) {
if (err.name === 'AbortError') {
throw new Error(`Request timed out after ${ms}ms`);
}
throw err;
}
}
✅ 进阶控制：组合多个信号（如手动取消 + 自动超时）
可通过 AbortSignal.any([...signals]) 合并多个信号，任一触发即中止：
- 用户主动调用
controller.abort()可提前终止 - 超时信号仍保留毫秒级精度，不受合并影响
- 适合带“取消按钮”的 UI 场景
示例：
const controller = new AbortController();
const timeoutSignal = AbortSignal.timeout(5000);
const combinedSignal = AbortSignal.any([controller.signal, timeoutSignal]);
fetch('/api/data', { signal: combinedSignal })
.catch(err => {
if (err.name === 'AbortError') {
console.log('Aborted either by user or timeout');
}
});
✅ 注意事项与边界情况
-
Node.js 版本要求严格：必须 ≥ v18.17.0 或 ≥ v20.5.0；旧版本不支持，需回退到
AbortController+setTimeout -
超时不是“强制杀连接”：它通知上层取消，具体是否立即断连取决于底层实现（如 fetch 会中断，但自定义流需自行监听
signal.aborted） - 不适用于同步逻辑：timeout() 只对异步可取消操作生效（如 fetch、stream.read()、Web Crypto 的某些方法），不能让普通 while 循环停住
-
避免重复使用同一 timeout() 信号：每个
AbortSignal.timeout(ms)返回新信号，不可复用；重复传给多个 fetch 会导致各自独立计时
不复杂但容易忽略：精度的前提是环境支持 + 正确集成。只要用对 API，毫秒级超时就是开箱即用的能力。
