浏览器与 Web API / 系统课时
使用 MutationObserver 监听节点变化
使用 MutationObserver 监听节点变化
直接修改 DOM 后,业务代码往往还需要同步统计、校验或更新其他区域。MutationObserver 能在一批 DOM 变更完成后异步收到记录,统一读取新增节点、属性变化和文本变化,避免反复轮询页面。
学习目标
- 创建观察器并开始监听目标节点
- 区分子节点、属性和文本三类变更记录
- 正确读取
MutationRecord中的关键字段
MutationObserver 如何工作
MutationObserver 接收一个回调函数。代码调用 observe() 后,浏览器会记录符合条件的 DOM 变更,并在当前同步任务结束后集中调用回调。回调参数是 MutationRecord 数组,同一轮连续修改可能对应多条记录。

观察选项决定记录范围:childList 监听直接子节点增删,attributes 监听属性,characterData 监听文本节点内容,subtree 则把范围扩展到全部后代。至少需要启用一种实际变更类型,否则 observe() 会抛出异常。
完整示例
下面页面监听列表新增、状态属性变化和文本修改。按钮点击后会连续执行三次 DOM 操作,观察器在同一轮回调中输出对应记录。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>MutationObserver 示例</title>
</head>
<body>
<button id="change">执行变更</button>
<ul id="task-list">
<li data-status="todo"><span>阅读文档</span></li>
</ul>
<pre id="log"></pre>
<script>
const list = document.querySelector("#task-list");
const log = document.querySelector("#log");
const observer = new MutationObserver((records) => {
const lines = records.map((record) => {
if (record.type === "childList") {
return `childList: 新增 ${record.addedNodes.length} 个节点`;
}
if (record.type === "attributes") {
return `attributes: ${record.attributeName} 从 ${record.oldValue} 变更`;
}
return `characterData: 文本从 ${record.oldValue} 变更`;
});
log.textContent = lines.join("\n");
});
observer.observe(list, {
childList: true,
attributes: true,
characterData: true,
subtree: true,
attributeOldValue: true,
characterDataOldValue: true
});
document.querySelector("#change").addEventListener("click", () => {
const firstItem = list.firstElementChild;
firstItem.dataset.status = "done";
firstItem.querySelector("span").firstChild.data = "阅读完成";
const newItem = document.createElement("li");
newItem.textContent = "整理笔记";
list.append(newItem);
});
</script>
</body>
</html>预期结果
点击“执行变更”后,页面日志会显示三类记录。不同浏览器可能合并部分连续修改,但记录类型和变更目标保持一致。
attributes: data-status 从 todo 变更
characterData: 文本从 阅读文档 变更
childList: 新增 1 个节点读取 MutationRecord
处理记录时先判断 record.type,再读取对应字段。childList 常用 addedNodes、removedNodes 和 target;attributes 常用 attributeName、oldValue;characterData 的 target 是文本节点,而不是包含它的元素。
oldValue 默认不会记录。只有启用 attributeOldValue 或 characterDataOldValue 后才会得到旧值。观察器只说明 DOM 发生了什么,不会自动告诉你是哪段业务代码触发了修改。
使用边界
回调中再次修改被观察区域可能产生新一轮记录,因此应避免无条件写回同一节点。大量变更时先按类型或目标合并处理,不要为每条记录立即执行昂贵布局读取。
观察器适合监听第三方组件、富文本区域或动态列表,但不应替代明确的数据状态管理。能够在业务操作点直接更新状态时,优先使用确定性的调用链。