浏览器与 Web API / 系统课时

使用 AbortController 统一清理事件

使用 AbortController 统一清理事件

组件反复挂载和销毁时,遗漏一个监听器就可能造成重复执行、内存占用或访问失效节点。本课将用共享 signal 管理多个监听器,并在销毁阶段通过一次 abort() 完成批量注销。

学习目标

  • 理解 AbortController、AbortSignal 与事件监听器之间的关系。
  • 能为多个监听器绑定同一个 signal,并统一清理。
  • 掌握重复挂载、信号复用和销毁验证的关键边界。

signal 如何接管监听器生命周期

AbortController 提供一个 signal 属性和一个 abort() 方法。把 signal 传入 addEventListener() 的选项后,浏览器会把该监听器登记到这个信号的清理集合中;信号中止时,对应监听器会被自动移除。

多个元素、多个事件类型甚至 window 上的监听器都可以共享同一个信号。这使组件销毁逻辑不再需要逐个保存回调引用,也不必逐项调用 removeEventListener()。

信号是一次性的。abort() 之后,signal.aborted 会保持为 true,不能重新恢复。组件再次挂载时必须创建新的 AbortController,否则新监听器会立即处于已中止状态。

主示例:批量注册与销毁

下面的组件同时监听按钮点击和全局键盘事件。两个监听器共享一个 signal,点击“销毁组件”后会一起失效。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>AbortController 清理事件示例</title>
</head>
<body>
  <button id="mount" type="button">挂载组件</button>
  <button id="unmount" type="button">销毁组件</button>
  <button id="action" type="button" disabled>执行动作</button>
  <pre id="log"></pre>

  <script>
    const logElement = document.querySelector("#log");

    function log(message) {
      logElement.textContent += `${message}\n`;
    }

    class DemoComponent {
      controller = null;

      constructor(actionButton) {
        this.actionButton = actionButton;
      }

      handleAction = () => {
        log("点击监听器执行");
      };

      handleKeydown = (event) => {
        if (event.key === "Enter") {
          log("Enter 监听器执行");
        }
      };

      mount() {
        // 重复挂载前先终止旧信号,避免监听器叠加
        this.unmount(false);
        this.controller = new AbortController();
        const { signal } = this.controller;

        this.actionButton.disabled = false;
        this.actionButton.addEventListener("click", this.handleAction, {
          signal
        });
        window.addEventListener("keydown", this.handleKeydown, {
          signal
        });

        signal.addEventListener(
          "abort",
          () => log("共享 signal 已中止,监听器已移除"),
          { once: true }
        );

        log("组件已挂载:点击按钮或按 Enter");
      }

      unmount(writeLog = true) {
        if (!this.controller) {
          return;
        }

        // 一次中止即可移除所有使用该 signal 的监听器
        this.controller.abort();
        this.controller = null;
        this.actionButton.disabled = true;

        if (writeLog) {
          log("组件已销毁");
        }
      }
    }

    const actionButton = document.querySelector("#action");
    const component = new DemoComponent(actionButton);

    document.querySelector("#mount").addEventListener("click", () => {
      component.mount();
    });

    document.querySelector("#unmount").addEventListener("click", () => {
      component.unmount();
    });
  </script>
</body>
</html>

预期结果。依次点击“挂载组件”“执行动作”,按一次 Enter,再点击“销毁组件”,日志显示:

text
组件已挂载:点击按钮或按 Enter
点击监听器执行
Enter 监听器执行
共享 signal 已中止,监听器已移除
组件已销毁

销毁后再次按 Enter 不会新增日志,“执行动作”按钮也已禁用。重新点击“挂载组件”会创建新控制器,监听器恢复且不会与上一轮叠加。

统一清理的生命周期

组件挂载时创建控制器,并把同一个 signal 交给所有属于该组件的监听器。组件卸载时调用 abort(),浏览器批量解除关联;再次挂载时创建新的控制器,开始下一轮生命周期。

AbortController 批量清理监听器生命周期

这种方式把“谁负责清理”从每个监听器转移到组件生命周期。只要注册时使用了同一个 signal,销毁逻辑就不需要知道具体有多少监听器,也不会因为遗漏某个回调而留下残余行为。

abort() 可以重复调用,后续调用不会再次触发有效清理。需要观察状态时可读取 signal.aborted;需要记录销毁原因时也可以向 abort(reason) 传入原因值,再从 signal.reason 读取。

使用边界与工程习惯

  • 控制器应由拥有这些监听器生命周期的组件或模块创建,不要把全局控制器随意共享给互不相关的功能。
  • signal 可以与 capture、passive、once 同时出现在监听选项中,它们分别控制不同维度。
  • 只有使用该信号注册的监听器会被清理;定时器、观察器或第三方订阅仍需调用各自的清理 API。
  • 若同一个信号还用于 fetch(),调用 abort() 也会取消请求,代码需要正确处理 AbortError。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 AbortController 统一清理事件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通