浏览器与 Web API / 系统课时
移除监听器与监听选项
移除监听器与监听选项
监听器不仅要正确注册,还要能在合适的时机自动或批量释放。本课通过一个完整页面说明 removeEventListener() 的匹配规则,并组合使用 once、passive、capture 和 AbortSignal 管理生命周期。
学习目标
- 正确匹配并移除已注册的事件监听器
- 说明四类监听选项各自改变的行为
- 使用
AbortController批量终止一组监听器
监听器能否移除取决于注册身份
调用 removeEventListener() 时,事件类型、回调函数引用和 capture 值必须与注册时一致。重新书写一个内容相同的匿名函数,会得到新的函数对象,因此无法移除原监听器。
在匹配移除时,once、passive 和 signal 不参与身份判断;capture 会参与。最稳妥的做法是保存具名函数,并在注册和移除时显式写出相同的 capture 值。

各选项的职责不同:once 让监听器成功触发一次后自动移除;passive 表示监听器不会调用 preventDefault(),浏览器可据此优化触摸或滚轮滚动;capture 决定监听器在捕获阶段执行;signal 把监听器生命周期交给一个 AbortController。
主示例:组合管理多种监听器
下面的页面同时演示手动移除、单次监听、捕获监听、被动滚轮监听和批量终止。保存为 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>预期结果
首次点击“只响应一次”会记录:
document 捕获监听器:已执行
once 监听器:仅执行一次
再次点击“只响应一次”时,只记录捕获监听器。
点击“普通监听器”会执行普通监听器;点击“移除普通监听器”后,再点击它不再执行。
点击“终止 signal 监听器”后,document 捕获监听器和 passive wheel 监听器都不再执行。abort 按钮自身没有绑定同一个 signal,因此它能够先终止其他监听器,再写入结果。浏览器处理点击时,捕获监听器会先于按钮监听器执行,所以终止操作所在的那次点击仍可能先记录一条捕获日志。
关键边界与选择建议
匿名函数适合不需要单独移除的短生命周期逻辑;需要手动解绑时,应使用可复用的具名函数。对组件销毁、页面切换或一组临时交互,AbortSignal 通常比逐个保存并移除回调更容易维护。
passive: true 是行为承诺,不是简单的性能开关。监听器内部若必须调用 preventDefault() 阻止滚动,就不能把它声明为被动监听器,否则取消操作不会生效,浏览器还可能输出警告。
注册捕获监听器后,移除时也必须传入 capture: true。下面两次调用中的函数引用和捕获值一致,因此可以正确移除。
function handleClick(event) {
console.log(event.target);
}
document.addEventListener("click", handleClick, { capture: true });
document.removeEventListener("click", handleClick, { capture: true });预期结果
移除完成后,后续点击不会再由 handleClick 输出目标元素。