浏览器与 Web API / 系统课时
MutationObserver 的过滤与清理
MutationObserver 的过滤与清理
观察范围过大时,MutationObserver 会产生大量无关记录,并让组件卸载后仍持有节点引用。本课通过 subtree、attributeFilter 和旧值选项缩小监听范围,再用 takeRecords() 与 disconnect() 完成可靠清理。
学习目标
- 使用过滤选项减少无关变更记录
- 理解
subtree与旧值选项的生效条件 - 在组件销毁前正确停止并清空观察器
过滤选项的组合规则
subtree: true 只扩大作用范围,本身不会启用任何记录类型。监听属性时必须设置 attributes: true,监听子节点时必须设置 childList: true。attributeFilter 只接收属性名数组,例如 ["class", "data-status"]。

attributeOldValue: true 会隐式要求属性监听,characterDataOldValue: true 会隐式要求文本监听。为了让配置意图清晰,实际项目中仍建议显式写出 attributes: true 或 characterData: true。
完整示例
下面示例只监听面板后代节点的 class 与 data-status 属性。点击“修改属性”时,style 变化会被过滤,另外两项会进入回调;点击“停止观察”后,后续修改不再产生新日志。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>MutationObserver 过滤与清理</title>
</head>
<body>
<button id="mutate">修改属性</button>
<button id="stop">停止观察</button>
<section id="panel">
<article id="card" class="card" data-status="idle">课程卡片</article>
</section>
<pre id="log"></pre>
<script>
const panel = document.querySelector("#panel");
const card = document.querySelector("#card");
const log = document.querySelector("#log");
const observer = new MutationObserver((records) => {
const lines = records.map(
(record) =>
`${record.attributeName}: ${record.oldValue} -> ` +
`${record.target.getAttribute(record.attributeName)}`
);
log.textContent += `${lines.join("\n")}\n`;
});
observer.observe(panel, {
attributes: true,
subtree: true,
attributeFilter: ["class", "data-status"],
attributeOldValue: true
});
document.querySelector("#mutate").addEventListener("click", () => {
card.className = "card active";
card.dataset.status = "ready";
card.style.borderWidth = "2px";
});
document.querySelector("#stop").addEventListener("click", () => {
const pending = observer.takeRecords();
observer.disconnect();
log.textContent += `已停止,待处理记录 ${pending.length} 条\n`;
});
</script>
</body>
</html>预期结果
先点击“修改属性”,日志只出现 class 和 data-status,不会出现 style。再点击“停止观察”后继续修改属性,日志保持不变。
class: card -> card active
data-status: idle -> ready
已停止,待处理记录 0 条回调通常会在当前点击事件结束后执行,因此示例中随后点击停止按钮时,待处理记录通常为 0。若在同一个同步任务里先修改再立即调用 takeRecords(),它会返回尚未送达回调的记录。
takeRecords 与 disconnect
takeRecords() 会取出并清空当前排队的记录,但不会停止观察。disconnect() 会停止所有目标的观察,并丢弃尚未回调的排队记录。因此,确实需要保留最后一批变化时,应先调用 takeRecords(),自行处理后再调用 disconnect()。
同一个观察器可以在 disconnect() 后再次调用 observe()。不过组件式代码更适合把观察器实例与组件生命周期绑定,卸载时清理引用,重新挂载时创建新的实例,避免旧回调闭包继续持有过期状态。
清理策略
在组件销毁、路由切换或临时监听结束时执行清理。除停止观察外,还应移除按钮事件、定时器等其他资源;disconnect() 只处理该观察器自身,不会替你清理外部副作用。
排查记录过多时,先缩小目标节点,再限制记录类型,最后添加 attributeFilter。不要一开始就对 document 使用 subtree: true 并开启所有类型,这会把大量无关 DOM 变化送入回调。