MutationObserver 是监听 DOM 变化的高效方案,可精准捕获属性、文本、节点增删等变化。通过实例化并配置 childList、attributes、characterData、subtree 等选项,指定目标节点开始监听;需监听文本变化时启用 characterData 与 characterDataOldValue;使用 observer.disconnect() 停止监听以避免内存泄漏,结合 takeRecords() 处理未完成记录,适用于组件卸载等场景。

要监听 DOM 的微妙变化,比如元素属性修改、文本内容更新或节点增删,MutationObserver 是目前最高效且标准的解决方案。它能精准捕获你关心的变更,避免轮询带来的性能损耗。
创建 MutationObserver 实例并配置监听选项
你需要先实例化 MutationObserver,并传入一个回调函数,该函数会在观察到变化时被触发。然后通过 observe() 方法指定目标节点和监听配置。
常见配置项包括:
- childList:监听子节点的增删
- attributes:监听属性变化
- characterData:监听文本内容或注释节点变化
- subtree:是否深度监听后代节点
- attributeFilter:只监听特定属性(如 ['class', 'style'])
- attributeOldValue:记录属性旧值
- characterDataOldValue:记录文本旧值
const observer = new MutationObserver((mutations) => {
mutations.forEach(mutation => {
console.log('变动类型:', mutation.type);
if (mutation.type === 'attributes') {
console.log('修改的属性:', mutation.attributeName);
console.log('旧值:', mutation.oldValue);
console.log('新值:', element.getAttribute(mutation.attributeName));
}
});
});
// 开始监听某个元素
const targetElement = document.getElementById('my-element');
observer.observe(targetElement, {
attributes: true,
attributeOldValue: true,
attributeFilter: ['class', 'data-status'],
childList: true,
subtree: true,
characterData: true,
characterDataOldValue: true
});
监听文本内容的细微变化
当需要监控某段文字是否被 JS 修改(比如倒计时、状态提示),characterData 配置非常有用。
立即学习“Java免费学习笔记(深入)”;
例如,监听一个 span 的文本更新:
const textNodeTarget = document.querySelector('#status');
const textObserver = new MutationObserver(mutations => {
mutations.forEach(mutation => {
if (mutation.type === 'characterData') {
console.log('原文本:', mutation.oldValue);
console.log('现文本:', mutation.target.nodeValue);
}
});
});
textObserver.observe(textNodeTarget, {
characterData: true,
characterDataOldValue: true
});
停止监听与资源清理
长时间运行的观察器可能造成内存泄漏,因此在不需要时应主动关闭。
可用的方法有:
- observer.disconnect():停止所有监听,不再触发回调
- observer.takeRecords():获取当前尚未处理的变更记录,常用于断开前收尾
典型使用场景是在组件卸载或页面切换时调用:
// 停止监听
observer.disconnect();
// 可选:清理前处理剩余变更
const leftoverMutations = observer.takeRecords();
console.log('断开前未处理的变更:', leftoverMutations);
基本上就这些。MutationObserver 虽强大,但别滥用。只监听必要的节点和变化类型,避免影响页面性能。配合合理的过滤和及时的断开,能让你准确掌握 DOM 的每一处微小变动。










