浏览器与 Web API / 系统课时

移除监听器与监听选项

移除监听器与监听选项

监听器不仅要正确注册,还要能在合适的时机自动或批量释放。本课通过一个完整页面说明 removeEventListener() 的匹配规则,并组合使用 once、passive、capture 和 AbortSignal 管理生命周期。

学习目标

  • 正确匹配并移除已注册的事件监听器
  • 说明四类监听选项各自改变的行为
  • 使用 AbortController 批量终止一组监听器

监听器能否移除取决于注册身份

调用 removeEventListener() 时,事件类型、回调函数引用和 capture 值必须与注册时一致。重新书写一个内容相同的匿名函数,会得到新的函数对象,因此无法移除原监听器。

在匹配移除时,once、passive 和 signal 不参与身份判断;capture 会参与。最稳妥的做法是保存具名函数,并在注册和移除时显式写出相同的 capture 值。

事件监听器的注册、活动与移除生命周期

各选项的职责不同:once 让监听器成功触发一次后自动移除;passive 表示监听器不会调用 preventDefault(),浏览器可据此优化触摸或滚轮滚动;capture 决定监听器在捕获阶段执行;signal 把监听器生命周期交给一个 AbortController。

主示例:组合管理多种监听器

下面的页面同时演示手动移除、单次监听、捕获监听、被动滚轮监听和批量终止。保存为 HTML 文件后在浏览器中打开,并按页面按钮操作。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>监听器生命周期</title>
  <style>
    #scroll-box {
      width: 320px;
      height: 100px;
      overflow: auto;
      border: 1px solid #999;
    }
    #scroll-content {
      height: 320px;
    }
  </style>
</head>
<body>
  <button id="ping">普通监听器</button>
  <button id="remove">移除普通监听器</button>
  <button id="once">只响应一次</button>
  <button id="abort">终止 signal 监听器</button>
  <div id="scroll-box">
    <div id="scroll-content">在此区域使用滚轮</div>
  </div>
  <pre id="log"></pre>

  <script>
    const log = document.querySelector("#log");
    const pingButton = document.querySelector("#ping");
    const removeButton = document.querySelector("#remove");
    const onceButton = document.querySelector("#once");
    const abortButton = document.querySelector("#abort");
    const scrollBox = document.querySelector("#scroll-box");
    const controller = new AbortController();

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

    function handlePing() {
      write("普通监听器:已执行");
    }

    function handleCapture() {
      write("document 捕获监听器:已执行");
    }

    pingButton.addEventListener("click", handlePing);

    removeButton.addEventListener("click", () => {
      pingButton.removeEventListener("click", handlePing);
      write("普通监听器:已移除");
    });

    onceButton.addEventListener("click", () => {
      write("once 监听器:仅执行一次");
    }, { once: true });

    document.addEventListener("click", handleCapture, {
      capture: true,
      signal: controller.signal
    });

    scrollBox.addEventListener("wheel", () => {
      write("passive wheel 监听器:已执行");
    }, {
      passive: true,
      signal: controller.signal
    });

    abortButton.addEventListener("click", () => {
      controller.abort(); // 一次移除所有使用该 signal 的监听器
      write("signal 监听器:已批量终止");
    });
  </script>
</body>
</html>

预期结果

text
首次点击“只响应一次”会记录:
document 捕获监听器:已执行
once 监听器:仅执行一次

再次点击“只响应一次”时,只记录捕获监听器。
点击“普通监听器”会执行普通监听器;点击“移除普通监听器”后,再点击它不再执行。
点击“终止 signal 监听器”后,document 捕获监听器和 passive wheel 监听器都不再执行。

abort 按钮自身没有绑定同一个 signal,因此它能够先终止其他监听器,再写入结果。浏览器处理点击时,捕获监听器会先于按钮监听器执行,所以终止操作所在的那次点击仍可能先记录一条捕获日志。

关键边界与选择建议

匿名函数适合不需要单独移除的短生命周期逻辑;需要手动解绑时,应使用可复用的具名函数。对组件销毁、页面切换或一组临时交互,AbortSignal 通常比逐个保存并移除回调更容易维护。

passive: true 是行为承诺,不是简单的性能开关。监听器内部若必须调用 preventDefault() 阻止滚动,就不能把它声明为被动监听器,否则取消操作不会生效,浏览器还可能输出警告。

注册捕获监听器后,移除时也必须传入 capture: true。下面两次调用中的函数引用和捕获值一致,因此可以正确移除。

js
function handleClick(event) {
  console.log(event.target);
}

document.addEventListener("click", handleClick, { capture: true });
document.removeEventListener("click", handleClick, { capture: true });

预期结果

text
移除完成后,后续点击不会再由 handleClick 输出目标元素。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

移除监听器与监听选项

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

登录哪都通