解决JSDOM中MutationObserver的“参数1不是Node类型”错误

解决jsdom中mutationobserver的“参数1不是node类型”错误

正如摘要所述,当你在JSDOM中使用MutationObserver时,可能会遇到一个令人困惑的错误:“TypeError: Failed to execute ‘observe’ on ‘MutationObserver’: parameter 1 is not of type ‘Node’”。 即使你确信传递给observe方法的参数是一个有效的DOM节点,该错误仍然可能出现。这通常是因为存在多个JSDOM实例,导致MutationObserver和DOM节点来自不同的JSDOM环境。

问题根源:多个JSDOM实例

在Jest测试环境中,jest-environment-jsdom 会自动创建一个全局的JSDOM实例。同时,你的测试代码可能又显式地创建了另一个JSDOM实例(例如,通过 new JSDOM())。

当你在测试中使用 new MutationObserver() 时,它会默认使用全局的JSDOM实例。但是,你传递给 observe 方法的DOM节点可能来自你显式创建的JSDOM实例。由于JSDOM不允许跨实例操作节点,因此会抛出上述错误。

解决方案:确保MutationObserver和DOM节点来自同一实例

解决这个问题的关键在于确保你使用的 MutationObserver 和DOM节点都来自同一个JSDOM实例。以下是几种可能的解决方案:

1. 使用JSDOM实例的MutationObserver

最直接的解决方案是将 MutationObserver 的创建与特定的JSDOM实例关联起来。例如,如果你创建了一个名为 dom 的JSDOM实例,那么你应该使用 new dom.window.MutationObserver() 来创建 MutationObserver。

修改后的代码示例:

import { JSDOM } from 'jsdom';import fs from 'fs';import path from 'path';const html = fs.readFileSync(path.resolve(__dirname, '../index.html'), 'utf8');let dom;let container;function waitForElm(dom, parentElm, selector) { // 传递dom实例  return new Promise(resolve => {    if (parentElm.querySelector(selector)) {      return resolve(parentElm.querySelector(selector));    }    const observer = new dom.window.MutationObserver(mutations => { // 使用dom实例的MutationObserver      if (parentElm.querySelector(selector)) {        resolve(parentElm.querySelector(selector));        observer.disconnect();      }    });    observer.observe(parentElm, {      childList: true,      subtree: true    });  });}describe('index.html', () => {  beforeEach(() => {    dom = new JSDOM(html, { runScripts: 'dangerously', resources: "usable" });  })  it('adds a tag', async () => {    container = dom.window.document.body.querySelector("#app-root");    const elm = await waitForElm(dom, container, '.my-embed'); // 传递dom实例    expect(container.querySelector('.my-embed')).not.toBeNull();  });});

在这个示例中,我们将 dom 实例传递给 waitForElm 函数,并在 waitForElm 函数中使用 dom.window.MutationObserver 创建 MutationObserver。这样可以确保 MutationObserver 和 parentElm 都来自同一个JSDOM实例。

注意事项:

这种方法需要你将JSDOM实例(或者至少是它的 window 对象)传递给所有需要使用 MutationObserver 的函数。

2. 使用全局的JSDOM实例

另一种解决方案是始终使用全局的JSDOM实例,并避免显式创建新的JSDOM实例。你可以通过 document 对象访问全局JSDOM实例。

修改后的代码示例:

import '@testing-library/jest-dom/extend-expect';import fs from 'fs';import path from 'path';const html = fs.readFileSync(path.resolve(__dirname, '../index.html'), 'utf8');//  不再显式创建 JSDOM 实例// let dom;let container;function waitForElm(parentElm, selector) {  return new Promise(resolve => {    if (parentElm.querySelector(selector)) {      return resolve(parentElm.querySelector(selector));    }    const observer = new MutationObserver(mutations => {      if (parentElm.querySelector(selector)) {        resolve(parentElm.querySelector(selector));        observer.disconnect();      }    });    observer.observe(parentElm, {      childList: true,      subtree: true    });  });}describe('index.html', () => {  beforeEach(() => {    //不再使用 new JSDOM,直接修改全局 document    document.documentElement.innerHTML = html;    // 或者使用 document.write(html);    // dom = new JSDOM(html, { runScripts: 'dangerously', resources: "usable" });  })  it('adds a tag', async () => {    container = document.body.querySelector("#app-root");    const elm = await waitForElm(container, '.my-embed');    expect(container.querySelector('.my-embed')).not.toBeNull();  });});

在这个示例中,我们不再显式创建JSDOM实例,而是直接修改全局的 document 对象的内容。 我们使用document.documentElement.innerHTML = html; 将HTML内容写入全局的JSDOM实例中。 这样,所有的DOM操作都将在同一个JSDOM实例中进行。

注意事项:

这种方法可能会影响其他测试用例,因为你正在修改全局状态。 因此,在使用这种方法时,请确保在每个测试用例之前重置全局状态。使用 document.write() 或 document.documentElement.innerHTML = … 设置HTML内容可能会导致一些副作用,例如重新加载脚本。你需要仔细评估这些副作用是否会影响你的测试结果。

总结

MutationObserver 在 JSDOM 中报错“参数1不是Node类型”通常是由于多个JSDOM实例引起的。为了解决这个问题,你需要确保 MutationObserver 和 DOM 节点都来自同一个 JSDOM 实例。 你可以选择使用 JSDOM 实例的 MutationObserver,或者始终使用全局的 JSDOM 实例。 选择哪种方法取决于你的具体需求和测试环境。 在选择解决方案时,请仔细评估每种方法的优缺点,并选择最适合你的情况的方法。

以上就是解决JSDOM中MutationObserver的“参数1不是Node类型”错误的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1510824.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月20日 06:12:11
下一篇 2025年12月20日 06:12:26

相关推荐

  • 如何利用 JavaScript 实现一个命令行界面工具来自动化工作流?

    使用Node.js和commander等库可创建CLI工具,通过解析命令行参数、执行系统操作(如git、npm)和文件处理实现自动化工作流,例如构建、部署项目,提升开发效率。 用 JavaScript 实现命令行工具来自动化工作流,核心是结合 Node.js 和一些专用库来解析命令、执行系统操作并输…

    2025年12月20日
    000
  • 使用 Mongoose 在复合索引文档中按部分索引进行搜索

    本文介绍了在使用 Mongoose 和 MongoDB 时,如何查询具有复合索引的文档,并且只需要匹配索引的部分字段。通过使用点符号和 $exists 操作符,可以有效地检索符合特定组织 ID 的所有文档,而无需提供完整的索引信息。本文将提供详细的示例代码和解释,帮助开发者理解和应用这种查询方法。 …

    2025年12月20日
    000
  • 使用 Mongoose 在复合索引文档中按索引的部分内容进行搜索

    本文档介绍了在使用 Mongoose 和 MongoDB 时,如何在复合索引文档中,仅使用索引的部分内容进行查询。重点讲解了使用点符号进行查询,以及避免全文档匹配时可能遇到的问题,并提供了相应的代码示例和注意事项,帮助开发者更有效地进行数据检索。 问题背景 在使用 Mongoose 和 MongoD…

    2025年12月20日
    000
  • 如何用Vue 3的Composition API重构大型项目?

    重构大型Vue项目需逐步迁移至Composition API,先分析Options API中数据、逻辑分散问题,识别可复用逻辑;再通过setup函数整合data、method与computed,提升代码组织性;接着将分页、权限等公共逻辑抽离为composable函数,增强复用性;最后结合Pinia优…

    2025年12月20日
    000
  • 在JavaScript中,如何实现剪贴板的读写操作?

    JavaScript通过Clipboard API操作剪贴板,需用户触发且页面在安全上下文中运行;2. 使用navigator.clipboard.writeText()写入文本,readText()读取文本,均返回Promise并需处理权限与异常。 在JavaScript中操作剪贴板,主要通过现代…

    2025年12月20日
    000
  • JavaScript的生成器函数如何模拟异步操作?

    生成器函数通过yield暂停执行,结合Promise和迭代器可模拟异步操作。使用function*定义的生成器返回迭代器,调用next()逐次推进,yield传出Promise,执行器等待完成后再将结果传回,实现类似async/await的同步写法效果。该机制避免回调地狱、支持错误捕获,为async…

    2025年12月20日
    000
  • JavaScript中的函数式编程概念(如Functor、Monad)如何理解?

    Functor是支持map方法的容器,能安全映射值并保持类型,如数组和Maybe;Monad是增强版Functor,提供chain方法以扁平化方式处理嵌套容器,适用于异步流程与错误处理,Promise即是Monad实例,通过组合函数提升代码可靠性。 函数式编程在JavaScript中越来越受到关注,…

    2025年12月20日
    000
  • JavaScript教程:高效检测带特定类名元素的焦点状态

    本文详细介绍了如何使用 document.activeElement 结合 classList.contains() 方法来判断具有特定 CSS 类名的 HTML 元素是否获得了焦点。通过监听元素的 focus 和 blur 事件,可以实时、准确地检测并响应用户界面中元素的焦点状态,解决直接比较元素…

    2025年12月20日
    000
  • JavaScript中高效重命名与转换大型对象属性的教程

    本教程详细阐述了如何在JavaScript中高效地对大型对象进行属性重命名和值类型转换。通过运用解构赋值(Destructuring Assignment)和扩展运算符(Spread Syntax),我们能够简洁、优雅地创建新对象,同时保留大部分原始属性,仅对指定字段进行修改和转换,从而优化代码可读…

    2025年12月20日
    000
  • 如何构建一个支持Tree-shaking的通用工具库?

    答案是构建支持Tree-shaking的工具库需使用ES模块语法、合理组织代码结构并配置打包工具。具体包括:采用export单独导出函数,避免默认或聚合导出;每个函数独立文件存放,入口文件仅重新导出;通过Rollup或Vite生成ESM格式产物;在package.json中设置module字段指向E…

    2025年12月20日
    000
  • 怎样利用Web Locks API管理资源并发访问?

    Web Locks API通过request方法提供命名的排他或共享锁,用于协调同源页面、Worker间的资源访问。使用mode区分读写操作,结合AbortSignal可防阻塞,确保关键逻辑原子性,但仅限客户端生效。 Web Locks API 提供了一种在单个浏览器上下文中协调对共享资源的访问方式…

    2025年12月20日
    000
  • 使用 Vue Router 构建多页面 Chrome 浏览器扩展

    本文将介绍如何使用 Vue Router 在 Chrome 浏览器扩展中实现多页面应用,例如登录页面和需要登录后才能访问的页面。通过 Vue Router,可以在单个 popup 页面中进行路由跳转,根据用户登录状态显示不同的内容,避免了为每个页面创建单独 popup 的复杂性。 1. 项目初始化与…

    2025年12月20日
    000
  • 如何判断具有特定类名的元素是否获得焦点

    本文将详细介绍如何利用 document.activeElement 属性结合 classList.contains() 方法来准确判断页面上具有特定CSS类名的元素是否当前获得焦点。我们将探讨 activeElement 的工作原理,并演示如何通过 focus 和 blur 事件监听器实时响应焦点…

    2025年12月20日
    000
  • 如何实现一个JavaScript的中间件模式,比如Express中的中间件?

    答案:实现一个类Express中间件系统,通过use添加函数到队列,run启动流程,next控制执行流转。核心是维护中间件数组并递归调用next执行下一个,支持同步与异步操作,可扩展错误处理。 实现一个类似 Express 的 JavaScript 中间件模式,核心是将多个函数串联起来,通过 nex…

    2025年12月20日
    000
  • JavaScript对象属性非空校验:字符串与数组的高效验证

    本文介绍一种高效方法,用于校验JavaScript对象中的字符串和数组属性是否为空。通过结合使用Object.values()和Array.prototype.every()方法,能够简洁地遍历对象的所有值,并确保所有字符串和数组类型的属性都具有非零长度,从而实现快速、可靠的数据验证。 引言:对象属…

    2025年12月20日
    000
  • JavaScript中检测带有特定类名的元素是否获得焦点

    本文探讨了如何利用 document.activeElement 属性结合 classList.contains() 方法,准确判断页面中具有特定CSS类名的元素是否获得了焦点。通过事件监听器实时响应用户交互,我们能够有效地跟踪焦点状态,并针对不同类名的元素进行精确识别和处理。 理解 documen…

    2025年12月20日
    000
  • 如何通过 JavaScript 的 Web Components 实现真正的组件复用?

    Web Components通过Shadow DOM、自定义元素和HTML模板实现跨框架复用。1. Shadow DOM隔离样式与结构,防止污染全局;2. 自定义元素支持语义化标签与属性监听,提升可操作性;3. 插槽机制增强内容灵活性;4. 封装逻辑并暴露事件与方法接口,实现解耦通信。合理运用这些技…

    2025年12月20日
    000
  • 如何构建一个可访问性(A11y)完备的UI组件库?

    构建可访问性完备的UI组件库需将A11y融入全流程:遵循WAI-ARIA标准,优先使用语义化HTML和原生元素,避免div模拟按钮;为自定义组件添加role、aria-label等属性;确保表单有label关联;模态框设置aria-modal并管理焦点进出;支持键盘导航,保持聚焦顺序与视觉一致,复合…

    2025年12月20日
    000
  • 优化React useEffect实现用户资料实时更新

    本文旨在解决React应用中用户登录后个人资料未能实时更新,需要刷新页面才能显示最新数据的问题。通过深入分析useEffect钩子的工作原理及其依赖项管理,文章提出了一种基于用户身份变化触发数据获取的解决方案,并提供了具体的代码示例和最佳实践,确保用户体验的流畅性。 问题分析:useEffect的触…

    2025年12月20日
    000
  • 如何实现一个基于WebRTC的屏幕共享功能?

    首先通过 getDisplayMedia() 获取屏幕视频流,再将其视频轨道添加到 RTCPeerConnection 中实现共享。需在 HTTPS 环境下调用 getDisplayMedia({ video: true }) 请求用户选择屏幕内容,成功后返回 MediaStream 并绑定到 vi…

    2025年12月20日
    000

发表回复

登录后才能评论
关注微信