浏览器与 Web API / 系统课时

MutationObserver 的过滤与清理

MutationObserver 的过滤与清理

观察范围过大时,MutationObserver 会产生大量无关记录,并让组件卸载后仍持有节点引用。本课通过 subtree、attributeFilter 和旧值选项缩小监听范围,再用 takeRecords() 与 disconnect() 完成可靠清理。

学习目标

  • 使用过滤选项减少无关变更记录
  • 理解 subtree 与旧值选项的生效条件
  • 在组件销毁前正确停止并清空观察器

过滤选项的组合规则

subtree: true 只扩大作用范围,本身不会启用任何记录类型。监听属性时必须设置 attributes: true,监听子节点时必须设置 childList: true。attributeFilter 只接收属性名数组,例如 ["class", "data-status"]。

MutationObserver 过滤与清理生命周期

attributeOldValue: true 会隐式要求属性监听,characterDataOldValue: true 会隐式要求文本监听。为了让配置意图清晰,实际项目中仍建议显式写出 attributes: true 或 characterData: true。

完整示例

下面示例只监听面板后代节点的 class 与 data-status 属性。点击“修改属性”时,style 变化会被过滤,另外两项会进入回调;点击“停止观察”后,后续修改不再产生新日志。

html
<!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。再点击“停止观察”后继续修改属性,日志保持不变。

text
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 变化送入回调。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

MutationObserver 的过滤与清理

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

登录哪都通