JavaScript 中的 AbortController：如何优雅地取消 fetch 与异步任务
在开发中我们经常遇到这样的场景：用户快速切换页面，但之前的接口请求还在进行；搜索框连续输入时，每敲一个字符就发一次请求，旧请求的结果可能覆盖新结果；或者文件上传过程中用户点击了取消按钮。这些情况如果不做处理，轻则浪费带宽和服务器资源，重则导致界面状态混乱。过去我们常用一个布尔标记或 XMLHttpRequest 的 abort 方法来中断请求，但代码零散且难以复用于 Promise 链。AbortController 是现代浏览器提供的标准 API，它让取消操作变得统一且可组合。这篇文章会从实际代码出发，讲清楚 AbortController 的基本用法、如何配合 fetch 取消请求、如何处理多个请求共用一个信号、以及它在非 fetch 异步任务中的巧妙应用。 ## 基本用法 AbortController 的接口非常简洁。创建一个控制器实例后，通过 `controller.signal` 拿到一个 AbortSignal 对象，把它传给需要取消的操作。调用 `controller.abort()` 就会触发 signal 上的 abort 事件。 ```js const controller = new AbortController(); const { signal } = controller; signal.addEventListener('abort', () => { console.log('操作被取消了'); }); controller.abort(); // 输出：操作被取消了 ``` 你可以通过 `signal.aborted` 判断是否已经取消。这个布尔值在调用 abort 后会永久变为 true。 ## 取消 fetch 请求 fetch 从设计之初就支持传入 signal。 ```js async function fetchData(url) { const controller = new AbortController(); const { signal } = controller; // 设置超时，比如 5 秒后自动取消 const timeoutId = setTimeout(() => controller.abort(), 5000); try { const response = await fetch(url, { signal }); const data = await response.json(); return data; } catch (err) { if (err.name === 'AbortError') { console.log('请求被取消或超时'); } else { throw err; } } finally { clearTimeout(timeoutId); } } ``` 要注意的是，当请求被 abort 时，fetch 返回的 Promise 会 reject 一个 name 为 `AbortError` 的 DOMException。你需要区分这个错误和网络错误。 ## 处理连续请求的竞态问题 搜索框输入联想是典型场景。每次输入都发请求，但返回顺序不确定。用 AbortController 可以保证只处理最后一次请求。 ```js let currentController = null; async function search(keyword) { if (currentController) { currentController.abort(); } currentController = new AbortController(); const { signal } = currentController; try { const res = await fetch(`/api/search?q=${encodeURIComponent(keyword)}`, { signal }); const list = await res.json(); renderList(list); } catch (err) { if (err.name !== 'AbortError') { console.error('搜索失败', err); } } } ``` 这里的关键是每次新请求前取消上一个控制器。如果上一个请求已经完成，abort 不会有任何副作用。 ## 多个请求共享一个信号 有时候我们需要一次性取消一组请求，比如页面卸载时取消所有进行中的请求。可以让多个 fetch 使用同一个 signal。 ```js const controller = new AbortController(); const { signal } = controller; const p1 = fetch('/api/a', { signal }); const p2 = fetch('/api/b', { signal }); // 组件卸载时 controller.abort(); // p1 和 p2 都会收到取消 ``` 但要注意，一旦 abort 被调用，这个 signal 就永久处于已取消状态，不能复用。需要重新创建控制器。 ## 让自定义异步任务支持取消 AbortController 不仅用于 fetch。你可以让任何异步操作监听 signal 的 abort 事件，然后主动清理或拒绝。 例如，一个模拟的延时任务： ```js function delay(ms, signal) { return new Promise((resolve, reject) => { const timer = setTimeout(resolve, ms); signal.addEventListener('abort', () => { clearTimeout(timer); reject(new DOMException('Aborted', 'AbortError')); }); }); } const controller = new AbortController(); const { signal } = controller; delay(3000, signal).then(() => console.log('完成')).catch(err => { if (err.name === 'AbortError') { console.log('延时被取消'); } }); setTimeout(() => controller.abort(), 1000); // 1 秒后取消 ``` 真实项目中，你可能会封装 websocket 连接、轮询逻辑或者文件读取，都可以用同样的方式接入 signal。 ## 与 Promise.race 的取舍 以前我们常用 Promise.race 来实现超时，比如 `Promise.race([fetch(url), timeout(5000)])`。但这种方式并不能真正取消底层的 fetch 请求，只是让外层的 Promise 提前结束，网络请求依然在继续。AbortController 能真正中断请求，释放连接资源。所以在需要取消的场景下，优先使用 AbortController。 ## 兼容性与 polyfill AbortController 在现代浏览器中支持良好。如果你需要支持较老的浏览器，可以引入 `abortcontroller-polyfill`。不过要注意，polyfill 无法取消原生的 fetch，只能让 API 存在，真正取消请求仍然需要浏览器支持。对于 Node.js，从 v15 开始也提供了全局的 AbortController（之前需要通过 `require('abort-controller')` 引入）。 ## 一些容易踩的坑 - 不要复用已经 abort 的 signal，一定要新建控制器。 - 在 catch 中一定要判断 `err.name === 'AbortError'`，不要把它当成真正的错误上报。 - 使用 `signal.throwIfAborted()` 可以在代码中快速抛出 AbortError（如果环境支持）。 - 如果同一个 signal 传给多个 fetch，其中一个被 abort 后，其他也会立即被取消，这是符合预期的。 - 在清理函数中移除事件监听，虽然 signal 本身是弱引用，但在一些长期存在的 signal 上仍建议用 `signal.addEventListener` 后适时移除，避免内存泄漏。 AbortController 让取消操作变成一种可传递、可组合的能力。下次写异步逻辑时，不妨把它作为默认的取消方案。 推荐查看天气：https://www.40tianqi.com/changning/40tian.html 推荐查看天气：https://www.40tianqi.com/zhaotong/ 推荐查看天气：https://www.40tianqi.com/zhaotong/zuotian.html 推荐查看天气：https://www.40tianqi.com/zhaotong/7tian.html 推荐查看天气：https://www.40tianqi.com/zhaotong/10tian.html 推荐查看天气：https://www.40tianqi.com/zhaotong/15tian.html 推荐查看天气：https://www.40tianqi.com/zhaotong/40tian.html 推荐查看天气：https://www.40tianqi.com/zhaoyang/ 推荐查看天气：https://www.40tianqi.com/zhaoyang/zuotian.html 推荐查看天气：https://www.40tianqi.com/zhaoyang/7tian.html 推荐查看天气：https://www.40tianqi.com/zhaoyang/10tian.html 推荐查看天气：https://www.40tianqi.com/zhaoyang/15tian.html 推荐查看天气：https://www.40tianqi.com/zhaoyang/40tian.html 推荐查看天气：https://www.40tianqi.com/ludian/ 推荐查看天气：https://www.40tianqi.com/ludian/zuotian.html 推荐查看天气：https://www.40tianqi.com/ludian/7tian.html 推荐查看天气：https://www.40tianqi.com/ludian/10tian.html 推荐查看天气：https://www.40tianqi.com/ludian/15tian.html 推荐查看天气：https://www.40tianqi.com/ludian/40tian.html 推荐查看天气：https://www.40tianqi.com/qiaojia/ 推荐查看天气：https://www.40tianqi.com/qiaojia/zuotian.html 推荐查看天气：https://www.40tianqi.com/qiaojia/7tian.html 推荐查看天气：https://www.40tianqi.com/qiaojia/10tian.html 推荐查看天气：https://www.40tianqi.com/qiaojia/15tian.html 推荐查看天气：https://www.40tianqi.com/qiaojia/40tian.html 推荐查看天气：https://www.40tianqi.com/yanjin/ 推荐查看天气：https://www.40tianqi.com/yanjin/zuotian.html 推荐查看天气：https://www.40tianqi.com/yanjin/7tian.html 推荐查看天气：https://www.40tianqi.com/yanjin/10tian.html 推荐查看天气：https://www.40tianqi.com/yanjin/15tian.html 推荐查看天气：https://www.40tianqi.com/yanjin/40tian.html 推荐查看天气：https://www.40tianqi.com/daguan/ 推荐查看天气：https://www.40tianqi.com/daguan/zuotian.html 推荐查看天气：https://www.40tianqi.com/daguan/7tian.html 推荐查看天气：https://www.40tianqi.com/daguan/10tian.html 推荐查看天气：https://www.40tianqi.com/daguan/15tian.html 推荐查看天气：https://www.40tianqi.com/daguan/40tian.html 推荐查看天气：https://www.40tianqi.com/yongshan/ 推荐查看天气：https://www.40tianqi.com/yongshan/zuotian.html 推荐查看天气：https://www.40tianqi.com/yongshan/7tian.html 推荐查看天气：https://www.40tianqi.com/yongshan/10tian.html 推荐查看天气：https://www.40tianqi.com/yongshan/15tian.html 推荐查看天气：https://www.40tianqi.com/yongshan/40tian.html 推荐查看天气：https://www.40tianqi.com/suijiang/ 推荐查看天气：https://www.40tianqi.com/suijiang/zuotian.html 推荐查看天气：https://www.40tianqi.com/suijiang/7tian.html 推荐查看天气：https://www.40tianqi.com/suijiang/10tian.html 推荐查看天气：https://www.40tianqi.com/suijiang/15tian.html 推荐查看天气：https://www.40tianqi.com/suijiang/40tian.html 推荐查看天气：https://www.40tianqi.com/zhenxiong/ 推荐查看天气：https://www.40tianqi.com/zhenxiong/zuotian.html 推荐查看天气：https://www.40tianqi.com/zhenxiong/7tian.html 推荐查看天气：https://www.40tianqi.com/zhenxiong/10tian.html 推荐查看天气：https://www.40tianqi.com/zhenxiong/15tian.html 推荐查看天气：https://www.40tianqi.com/zhenxiong/40tian.html 推荐查看天气：https://www.40tianqi.com/yiliang/ 推荐查看天气：https://www.40tianqi.com/yiliang/zuotian.html 推荐查看天气：https://www.40tianqi.com/yiliang/7tian.html 推荐查看天气：https://www.40tianqi.com/yiliang/10tian.html 推荐查看天气：https://www.40tianqi.com/yiliang/15tian.html 推荐查看天气：https://www.40tianqi.com/yiliang/40tian.html 推荐查看天气：https://www.40tianqi.com/weixin/ 推荐查看天气：https://www.40tianqi.com/weixin/zuotian.html 推荐查看天气：https://www.40tianqi.com/weixin/7tian.html 推荐查看天气：https://www.40tianqi.com/weixin/10tian.html 推荐查看天气：https://www.40tianqi.com/weixin/15tian.html 推荐查看天气：https://www.40tianqi.com/weixin/40tian.html 推荐查看天气：https://www.40tianqi.com/shuifu/ 推荐查看天气：https://www.40tianqi.com/shuifu/zuotian.html 推荐查看天气：https://www.40tianqi.com/shuifu/7tian.html 推荐查看天气：https://www.40tianqi.com/shuifu/10tian.html 推荐查看天气：https://www.40tianqi.com/shuifu/15tian.html 推荐查看天气：https://www.40tianqi.com/shuifu/40tian.html 推荐查看天气：https://www.40tianqi.com/lijiang/ 推荐查看天气：https://www.40tianqi.com/lijiang/zuotian.html 推荐查看天气：https://www.40tianqi.com/lijiang/7tian.html 推荐查看天气：https://www.40tianqi.com/lijiang/10tian.html 推荐查看天气：https://www.40tianqi.com/lijiang/15tian.html 推荐查看天气：https://www.40tianqi.com/lijiang/40tian.html 推荐查看天气：https://www.40tianqi.com/gucheng/ 推荐查看天气：https://www.40tianqi.com/gucheng/zuotian.html 推荐查看天气：https://www.40tianqi.com/gucheng/7tian.html 推荐查看天气：https://www.40tianqi.com/gucheng/10tian.html 推荐查看天气：https://www.40tianqi.com/gucheng/15tian.html 推荐查看天气：https://www.40tianqi.com/gucheng/40tian.html 推荐查看天气：https://www.40tianqi.com/yulong/ 推荐查看天气：https://www.40tianqi.com/yulong/zuotian.html 推荐查看天气：https://www.40tianqi.com/yulong/7tian.html 推荐查看天气：https://www.40tianqi.com/yulong/10tian.html 推荐查看天气：https://www.40tianqi.com/yulong/15tian.html 推荐查看天气：https://www.40tianqi.com/yulong/40tian.html 推荐查看天气：https://www.40tianqi.com/yongsheng/ 推荐查看天气：https://www.40tianqi.com/yongsheng/zuotian.html 推荐查看天气：https://www.40tianqi.com/yongsheng/7tian.html 推荐查看天气：https://www.40tianqi.com/yongsheng/10tian.html 推荐查看天气：https://www.40tianqi.com/yongsheng/15tian.html 推荐查看天气：https://www.40tianqi.com/yongsheng/40tian.html 推荐查看天气：https://www.40tianqi.com/huaping/ 推荐查看天气：https://www.40tianqi.com/huaping/zuotian.html 推荐查看天气：https://www.40tianqi.com/huaping/7tian.html 推荐查看天气：https://www.40tianqi.com/huaping/10tian.html 推荐查看天气：https://www.40tianqi.com/huaping/15tian.html 推荐查看天气：https://www.40tianqi.com/huaping/40tian.html 推荐查看天气：https://www.40tianqi.com/ninglang/ 推荐查看天气：https://www.40tianqi.com/ninglang/zuotian.html 推荐查看天气：https://www.40tianqi.com/ninglang/7tian.html 推荐查看天气：https://www.40tianqi.com/ninglang/10tian.html 推荐查看天气：https://www.40tianqi.com/ninglang/15tian.html 推荐查看天气：https://www.40tianqi.com/ninglang/40tian.html 推荐查看天气：https://www.40tianqi.com/puer/ 推荐查看天气：https://www.40tianqi.com/puer/zuotian.html 推荐查看天气：https://www.40tianqi.com/puer/7tian.html 推荐查看天气：https://www.40tianqi.com/puer/10tian.html 推荐查看天气：https://www.40tianqi.com/puer/15tian.html 推荐查看天气：https://www.40tianqi.com/puer/40tian.html 推荐查看天气：https://www.40tianqi.com/simao/ 推荐查看天气：https://www.40tianqi.com/simao/zuotian.html 推荐查看天气：https://www.40tianqi.com/simao/7tian.html 推荐查看天气：https://www.40tianqi.com/simao/10tian.html 推荐查看天气：https://www.40tianqi.com/simao/15tian.html 推荐查看天气：https://www.40tianqi.com/simao/40tian.html 推荐查看天气：https://www.40tianqi.com/ninger/ 推荐查看天气：https://www.40tianqi.com/ninger/zuotian.html 推荐查看天气：https://www.40tianqi.com/ninger/7tian.html 推荐查看天气：https://www.40tianqi.com/ninger/10tian.html 推荐查看天气：https://www.40tianqi.com/ninger/15tian.html 推荐查看天气：https://www.40tianqi.com/ninger/40tian.html 推荐查看天气：https://www.40tianqi.com/mojiang/ 推荐查看天气：https://www.40tianqi.com/mojiang/zuotian.html 推荐查看天气：https://www.40tianqi.com/mojiang/7tian.html 推荐查看天气：https://www.40tianqi.com/mojiang/10tian.html 推荐查看天气：https://www.40tianqi.com/mojiang/15tian.html 推荐查看天气：https://www.40tianqi.com/mojiang/40tian.html 推荐查看天气：https://www.40tianqi.com/jingdong/ 推荐查看天气：https://www.40tianqi.com/jingdong/zuotian.html 推荐查看天气：https://www.40tianqi.com/jingdong/7tian.html 推荐查看天气：https://www.40tianqi.com/jingdong/10tian.html 推荐查看天气：https://www.40tianqi.com/jingdong/15tian.html 推荐查看天气：https://www.40tianqi.com/jingdong/40tian.html 推荐查看天气：https://www.40tianqi.com/jinggu/ 推荐查看天气：https://www.40tianqi.com/jinggu/zuotian.html 推荐查看天气：https://www.40tianqi.com/jinggu/7tian.html 推荐查看天气：https://www.40tianqi.com/jinggu/10tian.html 推荐查看天气：https://www.40tianqi.com/jinggu/15tian.html 推荐查看天气：https://www.40tianqi.com/jinggu/40tian.html 推荐查看天气：https://www.40tianqi.com/simaozhenyuan/ 推荐查看天气：https://www.40tianqi.com/simaozhenyuan/zuotian.html 推荐查看天气：https://www.40tianqi.com/simaozhenyuan/7tian.html 推荐查看天气：https://www.40tianqi.com/simaozhenyuan/10tian.html 推荐查看天气：https://www.40tianqi.com/simaozhenyuan/15tian.html 推荐查看天气：https://www.40tianqi.com/simaozhenyuan/40tian.html 推荐查看天气：https://www.40tianqi.com/jiangcheng/ 推荐查看天气：https://www.40tianqi.com/jiangcheng/zuotian.html 推荐查看天气：https://www.40tianqi.com/jiangcheng/7tian.html 推荐查看天气：https://www.40tianqi.com/jiangcheng/10tian.html 推荐查看天气：https://www.40tianqi.com/jiangcheng/15tian.html 推荐查看天气：https://www.40tianqi.com/jiangcheng/40tian.html 推荐查看天气：https://www.40tianqi.com/menglian/ 推荐查看天气：https://www.40tianqi.com/menglian/zuotian.html 推荐查看天气：https://www.40tianqi.com/menglian/7tian.html 推荐查看天气：https://www.40tianqi.com/menglian/10tian.html 推荐查看天气：https://www.40tianqi.com/menglian/15tian.html 推荐查看天气：https://www.40tianqi.com/menglian/40tian.html 推荐查看天气：https://www.40tianqi.com/lancang/ 推荐查看天气：https://www.40tianqi.com/lancang/zuotian.html 推荐查看天气：https://www.40tianqi.com/lancang/7tian.html 推荐查看天气：https://www.40tianqi.com/lancang/10tian.html 推荐查看天气：https://www.40tianqi.com/lancang/15tian.html 推荐查看天气：https://www.40tianqi.com/lancang/40tian.html 推荐查看天气：https://www.40tianqi.com/ximeng/ 推荐查看天气：https://www.40tianqi.com/ximeng/zuotian.html 推荐查看天气：https://www.40tianqi.com/ximeng/7tian.html 推荐查看天气：https://www.40tianqi.com/ximeng/10tian.html 推荐查看天气：https://www.40tianqi.com/ximeng/15tian.html 推荐查看天气：https://www.40tianqi.com/ximeng/40tian.html 推荐查看天气：https://www.40tianqi.com/lincang/ 推荐查看天气：https://www.40tianqi.com/lincang/zuotian.html 推荐查看天气：https://www.40tianqi.com/lincang/7tian.html 推荐查看天气：https://www.40tianqi.com/lincang/10tian.html 推荐查看天气：https://www.40tianqi.com/lincang/15tian.html 推荐查看天气：https://www.40tianqi.com/lincang/40tian.html 推荐查看天气：https://www.40tianqi.com/linxiang/ 推荐查看天气：https://www.40tianqi.com/linxiang/zuotian.html 推荐查看天气：https://www.40tianqi.com/linxiang/7tian.html 推荐查看天气：https://www.40tianqi.com/linxiang/10tian.html 推荐查看天气：https://www.40tianqi.com/linxiang/15tian.html 推荐查看天气：https://www.40tianqi.com/linxiang/40tian.html 推荐查看天气：https://www.40tianqi.com/fengqing/ 推荐查看天气：https://www.40tianqi.com/fengqing/zuotian.html 推荐查看天气：https://www.40tianqi.com/fengqing/7tian.html 推荐查看天气：https://www.40tianqi.com/fengqing/10tian.html 推荐查看天气：https://www.40tianqi.com/fengqing/15tian.html 推荐查看天气：https://www.40tianqi.com/fengqing/40tian.html 推荐查看天气：https://www.40tianqi.com/yunxian/ 推荐查看天气：https://www.40tianqi.com/yunxian/zuotian.html 推荐查看天气：https://www.40tianqi.com/yunxian/7tian.html 推荐查看天气：https://www.40tianqi.com/yunxian/10tian.html 推荐查看天气：https://www.40tianqi.com/yunxian/15tian.html 推荐查看天气：https://www.40tianqi.com/yunxian/40tian.html 推荐查看天气：https://www.40tianqi.com/yongde/
