讲师中心 微信公众号
AI工具推荐 视频效率加速

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

千晨大大_2139

千晨大大_2139

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

|

850人浏览过

|

来源于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 绑定需手动处理)。

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

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

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

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

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

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

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

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

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

React Flow Architecture
React Flow Architecture

提供使用 React Flow 构建基于节点的 UI 的架构指导,适用于设计基于流程的应用程序,在状态管理、交互和性能等方面进行决策。

下载

立即学习“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。

相关文章

java速学教程(入门到精通)
java速学教程(入门到精通)

java怎么学习?java怎么入门?java在哪学?java怎么学才快?不用担心,这里为大家提供了java速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

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

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

3216

2024.01.03

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

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

286

2025.12.06

length函数用法
length函数用法

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

1687

2023.09.19

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

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

3816

2023.06.20

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

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

1215

2023.07.28

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

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

1558

2023.08.03

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

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

9263

2023.08.17

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

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

840

2023.09.01

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 16.8万人学习

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

共26课时 | 2.4万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn