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 拒绝,我们视其为预期并忽略。
相关术语
相关资源
相关课程
- Fetch API
学习请求取消。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。