Skip to content

AbortController

一句话解释

AbortController 提供一个信号,传给异步操作(如 fetch)以便稍后取消。

用大白话说

AbortController 是一个小对象,产生一个 AbortSignal。你把该信号传给异步操作——最常见的是 fetch——稍后调用 controller.abort() 即可取消。操作以 AbortError 拒绝,释放资源并停止网络流量。这解决了"过期请求"问题:用户在搜索框输入,你发起 fetch,他们又输入——你想取消第一个请求,以免其(已过时的)响应覆盖第二个。没有 abort,两个请求都会完成,最后解析的胜出,造成闪烁与带宽浪费。AbortSignal 可传给 fetch、addEventListener、ReadableStream 及越来越多的 API。你还可用 AbortSignal.any 合并多个信号,或用 AbortSignal.timeout(ms) 得到自取消信号。在 React 中,于 useEffect 清理中 abort 以避免卸载后 setState。

示例

javascript
let currentController = null;

async function search(query) {
  currentController?.abort(); // cancel previous
  currentController = new AbortController();
  try {
    const res = await fetch(`/api/search?q=${query}`, { signal: currentController.signal });
    return await res.json();
  } catch (e) {
    if (e.name === "AbortError") return null; // expected cancel
    throw e;
  }
}
search("a"); search("ab"); // first request is aborted

每次搜索取消上一个控制器。被中止的 fetch 以 AbortError 拒绝,我们视其为预期并忽略。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表