0

0

javascript的mutation observerapi如何使用_它如何观察dom树的变更【教程】

狼影

狼影

发布时间:2026-01-16 21:35:01

|

810人浏览过

|

来源于php中文网

原创

MutationObserver 构造函数必须传入一个普通函数作为回调,且需显式调用 observe() 方法并正确配置 options(如 childList、subtree、attributes 等),否则无法监听;回调中修改 DOM 易引发无限循环,应先 disconnect 再重新 observe 或使用标记位控制。

javascript的mutation observerapi如何使用_它如何观察dom树的变更【教程】

MutationObserver 构造函数怎么写才不会报错

直接 new MutationObserver() 会报 TypeError: Failed to construct 'MutationObserver': 2 arguments required, but only 1 present——回调函数是必填参数,且必须是函数类型,不能是箭头函数(若需 this 绑定需手动处理)。

  • 回调函数接收两个参数:mutationsListMutationRecord 数组)和 observer(当前实例),不要漏掉第二个
  • 构造后不会自动开始监听,必须显式调用 observe() 方法,否则什么也捕获不到
  • 不能重复用同一个实例监听多个不同根节点;如需监听多个目标,要么新建实例,要么确保目标有共同父级并设为 root

observe() 的 options 参数哪些关键项不能乱设

observe() 第二个参数是配置对象,常见误配导致“明明改了 DOM 却没触发回调”:

  • childList: true 才能捕获子节点增删(比如 el.appendChild()el.remove());仅设 subtree: true 不生效
  • subtree: true 是必要条件才能监听后代节点变化;但单独设它而没开 childListattributes 等,依然收不到事件
  • attributes: true 时,必须同时指定 attributeFilter: ['class', 'data-id'] 或设 attributeOldValue: true 才能看到旧值;否则 mutation.oldValueundefined
  • characterData: true 仅对文本节点内容变更有效(如 textNode.textContent = 'x'),对 input 输入框的 value 变更无效(那是 property,不是 DOM attribute 或 text node

如何避免无限循环:callback 里改 DOM 触发自身再次回调

这是最典型的死循环场景:在回调中修改被观察的 DOM,又触发新一轮 mutation,反复执行。常见于自动补全、高亮、懒加载等逻辑。

  • 最稳妥做法:在回调开头调用 observer.disconnect(),完成修改后再 observer.observe() 恢复监听
  • 次选方案:加标记位(如 isHandling = true),修改前设为 true,回调开头检查,为 truereturn;修改完再重置
  • 注意:不能依赖 mutationsList.length 判断是否“自己触发”,因为浏览器可能批量合并多次变更,也可能跨异步任务触发

实际监听一个动态表格的新增行和属性变更

假设页面有个 <table id="user-table">,JS 动态插入 <tr data-user-id="123">,且后续可能修改某行的 data-status 属性:

雾象
雾象

WaytoAGI推出的AI动画生成引擎

下载

立即学习Java免费学习笔记(深入)”;

const table = document.getElementById('user-table');
const observer = new MutationObserver((mutations) => {
  mutations.forEach(mutation => {
    if (mutation.type === 'childList') {
      mutation.addedNodes.forEach(node => {
        if (node.nodeType === 1 && node.tagName === 'TR') {
          console.log('新增行,ID:', node.dataset.userId);
        }
      });
    } else if (mutation.type === 'attributes') {
      if (mutation.attributeName === 'data-status') {
        console.log('状态变更:', mutation.target, '→', mutation.target.dataset.status);
      }
    }
  });
});

observer.observe(table, {
  childList: true,
  subtree: true,
  attributes: true,
  attributeFilter: ['data-status'],
  attributeOldValue: true
});

这里没开 characterData,因为表格行内文本变更不属于该监听范围;attributeFilter 缩小监听粒度,避免无关属性变动干扰性能。

真实项目中,如果表格渲染由框架(如 React/Vue)驱动,MutationObserver 很可能捕获不到——因为框架通常复用节点、只更新 property 或 innerHTML,DOM 结构本身未变。这时候应优先走框架自身的响应式机制,而非硬套 MutationObserver。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

871

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

32

2025.12.06

length函数用法
length函数用法

length函数用于返回指定字符串的字符数或字节数。可以用于计算字符串的长度,以便在查询和处理字符串数据时进行操作和判断。 需要注意的是length函数计算的是字符串的字符数,而不是字节数。对于多字节字符集,一个字符可能由多个字节组成。因此,length函数在计算字符串长度时会将多字节字符作为一个字符来计算。更多关于length函数的用法,大家可以阅读本专题下面的文章。

954

2023.09.19

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

531

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

576

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

6230

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

492

2023.09.01

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 9.5万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号