2025年MutationObserver 方法

MutationObserver 是什么

MutationObserver API 让我们能监听 DOM 树变化，该 API 设计用来替换掉在 DOM 3 事件规范中引入的 Mutation events。

Mutation events 是同步触发的，每次变动都会触发一次调用。
MutationObserver API 是异步触发的， DOM 的变动并不会马上触发，而是要等到当前所有 DOM 操作都结束才触发。所以 MutationObserver 相比 Mutation events 性能要更高。

代码示例

// 某个需要被监控的 dom 元素。

var targetNode = document.getElementById('elem-id');

//配置 dom 的哪些改变会触发回调函数，详细见下文表格。

var mutationObserverInitConfig = { 

 attributes: true, childList: true, subtree: true };

// dom 变化时触发的回调函数，传入 mutationsList：记录 dom 变化的对象数组。

var callback = function(mutationsList) { 



for(var mutation of mutationsList) { 



console.log( 'dom 变化啦！');

youCoreFun();

}

};

// 创建一个 MutationObserver 示例，传入回调函数

var observer = new MutationObserver(callback);

// 注册监控的节点、监控的事件

observer.observe(targetNode, mutationObserverInitConfig);

// 停止监控

observer.disconnect();

MutationObserver 允许我们订阅某个dom元素的某些事件变化：

初始化

var callback = function(mutationsList) { 



// mutationsList:数组类型的通知队列，其元素 MutationRecord 记录触发变化的详细信息。

// mutationsList：[MutationRecord,MutationRecord]

};

var observer = new MutationObserver(callback);

MutationRecord

每次 dom 变动都会触发通知，合理利用 MutationRecord 进行条件判断，避免执行不必要的 callback 操作。

属性	描述
type	根据变动类型的不同，值可能性：attributes，characterData、childList
target	触发通知的DOM节点
addedNodes	被添加的节点
removedNodes	被删除的节点
previousSibling	被添加或被删除的节点的前一个兄弟节点
nextSibling	被添加或被删除的节点的后一个兄弟节点
attributeName	发生变更的属性的名称
attributeNamespace	发生变更的属性的命名空间
oldValue	果 type 为 characterData，则返回该节点变化之前的文本数据；如果 type为 childList，则返回 null

方法详解

observe(dom,configObj)

observer.observe(targetNode, { 



attributes: true,

childList: true,

subtree: true

});

调用 observe 后开始接收通知，触发初始化 MutationObserver 实例时传入的回调函数。

mutationObserverInit 字典

MutationObserver 配置信息，observe 函数的第二个入参，对象类型。

属性	类型	描述	默认值
childList	Boolean	观察子节点变动	false
subtree	Boolean	观察所有后代节点的变动	false
attributes	Boolean	观察属性的变动	false
attributeFilter	Array	属性过滤器，例如：传入[“status”]，仅在属性 status 变化时触发回调	无
attributeOldValue	Boolean	是否记录 attributes 变动前的属性值	无
characterData	Boolean	观察字符数据的变化	无
characterDataOldValue	Boolean	是否记录 characterData 变动前的属性值	无

注意

childList 和 subtree 指定了监视范围（子节点或者所有后代节点），attributes 和 characterData 配置是否在监视范围内监控目标节点属性、文本的变化。

childList，attributes 或者 characterData 三个属性之中，至少有一个必须为 true，否则会抛出 TypeError 异常。

disconnect()

observer.disconnect();

告诉观察者停止观察变动。可以通过调用其observe()方法来重用观察者。所有已经检测到但是尚未向观察者报告的变动都会被丢弃。

takeRecords()

observer.takeRecords();

除了被动等待变化事件通知，我们还可以使用 takeRecords 函数主动从通知队列中拉取所有待处理的通知。

需要注意的是调用 takeRecords 函数后，通知队列为空，不会触发回调函数。

takeRecords例子

浏览器兼容性

不兼容的浏览器可以使用旧 API Mutation events 作为替代方案。

参考资料

张鑫旭-聊聊JS DOM变化的监听检测与应用

Santiago García da Rosa
-JavaScript: MutationObserver

MDN-MutationObserver

JavaScript 标准参考教程-Mutation Observer API

逆葵-深入 MutationObserver