使用 abortcontroller 实例的 abort() 方法可以取消正在发送的 fetch 请求。具体做法是在发起请求前创建控制器,将它的 signal 属性传给 fetch 的第二个参数对象;当需要取消时调用 controller.abort(),此时对应的请求会立即终止并抛出一个 aborterror。

fetch 如何接收信号以支持取消
在 JavaScript 中,fetch API 通过配置选项中的 signal 字段来监听取消指令。开发者只需创建一个 AbortController 对象,获取其 signal 属性,并将其作为第二个参数的键值对传入即可。这样浏览器内部就会建立一条通道,一旦控制器被中止,网络层就会中断该请求。

// 1. 创建控制器
const controller = new AbortController();
const signal = controller.signal;
// 2. 发起请求并传入 signal
fetch('https://api.example.com/data', {
signal: signal
})
.then(response => response.json())
.then(data => console.log('Success:', data))
.catch(error => {
if (error.name === 'AbortError') {
console.log('Request cancelled');
} else {
console.error('Fetch error:', error);
}
});
// 3. 在某个时刻触发取消
// controller.abort();
上述代码展示了标准的请求流程。关键点在于 fetch 的第二个参数对象必须包含 signal 属性。如果不传这个属性,请求将无法被外部主动取消。运行这段代码后,如果不调用 abort(),请求会正常完成;如果调用了,控制台会打印 "Request cancelled"。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何处理取消后的异常与资源清理
当请求被取消时,fetch 返回的 Promise 会被拒绝(Reject),抛出的错误对象名为 AbortError。开发者必须在 catch 块中捕获这个特定的错误,以免它被视为普通网络故障。此外,如果请求关联了其他副作用(如定时器或 DOM 事件监听器),应在取消时一并清理,防止内存泄漏。

const controller = new AbortController();
let timerId;
function startRequest() {
// 模拟一个需要清理的定时器
timerId = setTimeout(() => {
console.log('Timer completed');
}, 5000);
fetch('https://api.example.com/data', {
signal: controller.signal
})
.then(res => res.json())
.then(data => {
clearTimeout(timerId); // 成功时清理
console.log(data);
})
.catch(err => {
if (err.name === 'AbortError') {
clearTimeout(timerId); // 取消时清理
console.log('Aborted and cleaned up');
} else {
console.error(err);
}
});
}
// 触发取消
setTimeout(() => controller.abort(), 1000);
在这个例子中,我们引入了一个定时器来演示资源清理。当 controller.abort() 被调用后,fetch 抛出 AbortError,进入 catch 分支。我们在分支内调用了 clearTimeout,确保定时器不会在请求取消后继续执行。这种模式保证了即使请求被提前终止,相关的辅助资源也能得到妥善释放。
基于 signal.aborted 状态的具体问题
在程序运行过程中,有时需要判断当前请求是否已经被取消,而不是等待异常抛出。可以通过检查 signal.aborted 属性的布尔值来实现。如果该值为 true,说明 abort() 已被调用,此时可以跳过后续的数据处理逻辑,直接进行清理工作。
const controller = new AbortController();
fetch('https://api.example.com/data', {
signal: controller.signal
})
.then(res => {
if (controller.signal.aborted) {
console.log('Skip processing due to abort');
return;
}
return res.json();
})
.then(data => console.log(data));
controller.abort();
这段代码展示了如何在 then 链中显式检查 signal.aborted。虽然 fetch 本身会在取消时抛出异常,但在某些复杂的数据处理管道中,提前检查状态可以避免不必要的计算。运行此代码,由于在请求完成前调用了 abort(),控制台会输出 "Skip processing due to abort",而不会尝试解析 JSON 数据。

















