Frontend Academy · 课时

使用 AbortController 进行清理

创建 AbortController，将其信号传递给 fetch，并在清理函数中取消进行中的请求，防止已卸载组件更新状态。

使用 AbortController 进行清理 是 CoddyKit 上的免费 Frontend Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Frontend Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Frontend Academy 课程共包含 4 节课。

为什么要取消获取请求

当组件卸载或重新获取数据时，之前的请求可能仍在进行。如果它在新请求之后完成，过期数据就会覆盖最新数据。AbortController 可以干净地取消正在进行的请求。

AbortController 基础

创建一个 AbortController，将其 signal 传递给获取请求，然后调用 controller.abort() 进行取消。请求被取消时会抛出 AbortError。

const controller = new AbortController();

try {
  const res = await fetch('/api/data', { signal: controller.signal });
  const data = await res.json();
  setData(data);
} catch (err) {
  if (err instanceof DOMException && err.name === 'AbortError') {
    console.log('Request was cancelled');
  } else {
    setError((err as Error).message);
  }
}

// To cancel:
controller.abort();

在 useEffect 清理中使用

在副作用开始时创建一个 AbortController，并在清理函数中调用 abort()。当依赖项变化或组件卸载时，这会自动取消请求。

useEffect(() => {
  const controller = new AbortController();

  async function load() {
    try {
      const res = await fetch(`/api/user/${userId}`, { signal: controller.signal });
      if (!res.ok) throw new Error(`${res.status}`);
      setUser(await res.json());
    } catch (err) {
      if ((err as DOMException).name !== 'AbortError') {
        setError((err as Error).message);
      }
    }
  }

  load();
  return () => controller.abort();
}, [userId]);

AbortError 与网络错误

被取消的请求会抛出名称为“AbortError”的 DOMException。请始终单独检查它，不要将其显示为用户可见的错误——这是预期的清理行为。

signal.aborted 属性

检查 controller.signal.aborted，以确认信号是否已被取消。在异步代码中调用 setState 前进行检查非常有用。

const data = await fetchData();
if (!controller.signal.aborted) {
  setData(data); // safe to update state
}

取消多个请求

将同一个信号传递给多个获取请求，即可使用一个 AbortController 取消多个请求。

const controller = new AbortController();
const { signal } = controller;

await Promise.all([
  fetch('/api/users',    { signal }),
  fetch('/api/products', { signal }),
  fetch('/api/settings', { signal }),
]);

controller.abort(); // cancels all three

AbortController 与 Axios

Axios 支持通过配置中的 signal 选项使用 AbortController 的信号。该信号接口与获取请求使用的接口相同。

const controller = new AbortController();
await axios.get('/api/data', { signal: controller.signal });

// In cleanup:
return () => controller.abort();

React Query 会自动处理这些工作

使用 TanStack Query（React Query）时，取消操作会由它自动处理。React Query 会在内部创建并取消控制器。这是优先选择它而不是手动获取模式的原因之一。

使用 AbortController 设置超时

将 AbortController 与 setTimeout 结合起来，即可实现请求超时。

const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 5000); // 5s timeout

try {
  const data = await fetch(url, { signal: controller.signal });
  // ...
} finally {
  clearTimeout(timeoutId);
}

AbortSignal.timeout()——现代快捷方式

在现代浏览器中，AbortSignal.timeout(ms) 会创建一个信号，在指定时长后自动取消，无需手动创建控制器。

const res = await fetch('/api/data', {
  signal: AbortSignal.timeout(5000) // 5 second timeout
});

React 18 严格模式中的清理至关重要

React 18 严格模式会在开发环境中让副作用挂载两次。如果没有 AbortController 清理逻辑，您会看到重复请求，以及组件卸载后更新状态的潜在警告。清理模式可以防止这两种情况。

快速检查

如何防止过期的网络响应在组件重新渲染后更新状态？

回顾：AbortController

每个副作用创建一个 AbortController。将 signal 传递给获取请求或 axios。在清理函数中取消请求。忽略 AbortError——这是预期行为。在异步代码中调用 setState 前检查 signal.aborted。一个控制器可以取消多个请求。使用 AbortSignal.timeout() 设置超时。React Query 会自动处理所有这些工作。

常见问题解答

「使用 AbortController 进行清理」课时是免费的吗？

是的 — 「使用 AbortController 进行清理」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Frontend Academy 课程的其余内容，请升级到 CoddyKit PRO。 Frontend Academy 课程共包含 4 节课。

「使用 AbortController 进行清理」这节课中我会学到什么？

创建 AbortController，将其信号传递给 fetch，并在清理函数中取消进行中的请求，防止已卸载组件更新状态。你通过在浏览器中直接运行的动手代码来练习 Frontend Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Frontend Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Frontend Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「使用 AbortController 进行清理」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Frontend Academy 课中编写并运行代码吗？

能。每节 Frontend Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Frontend Academy