大网数据广告活动
Web 标准与前端开发

AbortSignal:any() 静态方法

· 52CE 我爱测

`AbortSignal.any()`** 静态方法接收一个中止信号的可迭代对象,并返回一个 AbortSignal。当输入的可迭代对象中的任何一个中止信号被中止时,返回的中止信号也会被中止。AbortSignal.reason将被设置为第一个被中止的信号的中止原因。如果给定的中止信号中有任何一个已经被中止,那么返回的 AbortSignal 也将是已中止状态。

DOM

AbortSignal.any() 静态方法接收一个中止信号的可迭代对象,并返回一个 AbortSignal。当输入的可迭代对象中的任何一个中止信号被中止时,返回的中止信号也会被中止。AbortSignal.reason将被设置为第一个被中止的信号的中止原因。如果给定的中止信号中有任何一个已经被中止,那么返回的 AbortSignal 也将是已中止状态。

语法

AbortSignal.any(iterable)

参数

返回值

AbortSignal,其状态为:

  • 已中止,如果给定的中止信号中有任何一个已经被中止。返回的 AbortSignal 的 reason 将被设置为第一个已中止的中止信号的 AbortSignal.reason。
  • 异步中止,当 iterable 中的任何中止信号被中止时。AbortSignal.reason 将被设置为第一个被中止的中止信号的中止原因。

示例

使用 AbortSignal.any()

此示例演示了如何将来自 AbortController 的信号与来自 AbortSignal/timeout_static 的超时信号组合在一起。

const cancelDownloadButton = document.getElementById("cancelDownloadButton");

const userCancelController = new AbortController();

cancelDownloadButton.addEventListener("click", () => {
  userCancelController.abort();
});

// 5 分钟后超时
const timeoutSignal = AbortSignal.timeout(1_000 * 60 * 5);

// 当用户点击取消按钮或 5 分钟时间到时(以先发生者为准),此信号将中止
const combinedSignal = AbortSignal.any([
  userCancelController.signal,
  timeoutSignal,
]);

try {
  const res = await fetch(someUrlToDownload, {
    // 当任何信号中止时停止 fetch
    signal: combinedSignal,
  });
  const body = await res.blob();
  // 对下载的内容进行处理:
  // …
} catch (e) {
  if (e.name === "AbortError") {
    // 被用户取消
  } else if (e.name === "TimeoutError") {
    // 向用户显示下载超时
  } else {
    // 其他错误,例如网络错误
  }
}

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。