AbortSignal.any 本质是信号聚合而非 Promise.race，监听任一传入信号 abort 后立即生成已中止的新信号；返回 AbortSignal 非 Promise，要求所有输入信号 active 且非空，不暴露触发源需自行追踪原因，兼容性需 polyfill 降级。
AbortSignal.any 本质是信号聚合，不是 Promise.race
它不等待任意一个异步操作完成，而是监听多个 AbortSignal 中**任一被 abort** 的瞬间，立刻生成一个已中止的新信号。这意味着你不能用它“竞速”请求结果，只能用来统一响应多个取消源的任意一次触发。
常见错误是把它当 Promise.race([fetch(), timeout()]) 用——结果发现 fetch 成功了，但信号早已被 timeout abort，导致后续逻辑误判为失败。
-
AbortSignal.any返回的是新AbortSignal，不是 Promise，不能 await - 所有传入的信号必须是 active 状态；若其中已有被 abort 的信号，返回信号立即进入 aborted 状态
- 不支持空数组或 null —— 会抛
TypeError: Failed to execute 'any' on 'AbortSignal': At least one signal must be provided
组合页面关闭、用户点击、超时三类取消源的典型写法
比如一个长轮询请求，需要同时响应：用户点“取消”按钮、浏览器标签页即将关闭（beforeunload）、单次请求超过 8 秒自动终止。
关键点在于：每个源都要独立生成自己的 AbortController，再把它们的 .signal 传给 AbortSignal.any：
const controller = new AbortController();
const clickCtrl = new AbortController();
const timeoutCtrl = new AbortController();
<p>// 用户点击取消
cancelBtn.addEventListener('click', () => clickCtrl.abort());</p><p>// 页面卸载前
window.addEventListener('beforeunload', () => controller.abort());</p><p>// 超时控制（注意：setTimeout 后需手动 abort）
setTimeout(() => timeoutCtrl.abort(), 8000);</p><p>// 聚合三个信号
const combinedSignal = AbortSignal.any([
controller.signal,
clickCtrl.signal,
timeoutCtrl.signal
]);</p><p>// 使用
fetch('/api/stream', { signal: combinedSignal })
.then(r => r.json())
.catch(err => {
if (err.name === 'AbortError') {
// 真正的取消原因需额外追踪（见下节）
}
});AbortSignal.any 不暴露哪个信号先触发，需自行记录原因
这是最容易被忽略的坑：AbortSignal.any 生成的信号被 abort 后，combinedSignal.aborted 为 true，但 combinedSignal.reason 始终是 undefined —— 浏览器不透出源头。
- 无法仅靠
signal.reason区分是用户点了取消，还是超时了 - 如果业务逻辑依赖取消原因（比如上报埋点、重试策略），必须在每个
abort()前打标记 - 推荐用闭包或 WeakMap 关联控制器与原因字符串，避免污染全局
示例补丁：
const abortReasons = new WeakMap();
abortReasons.set(clickCtrl, 'user_click');
abortReasons.set(timeoutCtrl, 'timeout');
abortReasons.set(controller, 'page_unload');
<p>const combinedSignal = AbortSignal.any([
controller.signal,
clickCtrl.signal,
timeoutCtrl.signal
]);</p><p>// 监听 combinedSignal 的 abort 事件来捕获源头
combinedSignal.addEventListener('abort', () => {
for (const ctrl of [controller, clickCtrl, timeoutCtrl]) {
if (ctrl.signal.aborted) {
console.log('aborted by:', abortReasons.get(ctrl));
break;
}
}
}, { once: true });兼容性与 polyfill 注意事项
AbortSignal.any 是较新的 API（Chrome 115+、Firefox 117+、Safari 16.4+ 支持），旧环境需降级处理。
- 不能简单 fallback 到
new AbortController().signal—— 这会丢失所有取消能力 - 可靠降级是监听所有源的
abort事件，手动调用主控制器的abort()，并维护一个状态位 - npm 上的
abort-controller-polyfill目前不包含AbortSignal.any实现，需自行补充 - 若项目已用
react-query或swr，注意它们的signal透传逻辑可能绕过你的聚合信号，需检查中间层是否劫持了 abort 行为
真正麻烦的不是写法，而是当多个取消源语义不同（比如“用户放弃”该清缓存，“超时”该自动重试，“页面关闭”该发日志）时，AbortSignal.any 强制你把它们压平成同一个信号流——这时候得在 abort 前做决策，而不是之后猜。
