本文详细阐述了在 cypress 测试中，当目标元素位于 shadow dom 内部时，标准选择器失效的原因及解决方案。教程将指导读者如何识别 shadow host 并利用 cypress 的 `.shadow()` 命令，有效定位并与 shadow dom 中的表单元素进行交互，确保测试的准确性和稳定性。

在现代 Web 开发中，组件化和封装性变得越来越重要。Shadow DOM 作为 Web Components 技术栈的一部分，提供了一种强大的方式来封装组件的结构、样式和行为，使其与文档的其他部分完全隔离。然而，这种封装性也给自动化测试工具带来了挑战，尤其是在使用 Cypress 这类工具进行元素定位时。

理解 Shadow DOM 及其对 Cypress 的影响

Shadow DOM 允许浏览器将一个 DOM 子树（称为 Shadow Tree）附加到一个常规 DOM 元素（称为 Shadow Host）上。这个 Shadow Tree 是独立于主文档 DOM 的，其内部的元素默认不会被主文档的 CSS 或 J*aScript 直接访问。对于 Cypress 而言，这意味着标准的 cy.get() 命令在尝试定位 Shadow DOM 内部的元素时会失败，因为它只能在主文档 DOM 中进行查找。

当 Cypress 尝试使用 cy.get('input[name=firstName]') 这样的选择器去定位一个位于 Shadow DOM 内部的输入框时，如果该输入框不直接存在于主文档 DOM 中，Cypress 将无法找到它，并最终抛出超时错误，提示“Expected to find element: input[name=firstName], but never found it.”。

解决方案：使用 Cypress 的 .shadow() 命令

Cypress 提供了专门的 .shadow() 命令来解决 Shadow DOM 的元素定位问题。.shadow() 命令允许您穿透 Shadow DOM 的边界，进入 Shadow Tree 内部进行元素操作。

.shadow() 命令的工作原理

要成功使用 .shadow() 命令，关键在于两步：

小爱开放平台

小米旗下小爱开放平台

291 查看详情

1. 定位 Shadow Host： 首先，您需要使用常规的 Cypress 选择器定位到承载 Shadow DOM 的宿主元素（Shadow Host）。这个 Shadow Host 必须是主文档 DOM 中的一个可见元素。
2. 进入 Shadow DOM 并定位内部元素： 一旦定位到 Shadow Host，您可以链式调用 .shadow() 命令。此命令会改变 Cypress 的上下文，使其能够在 Shadow Tree 内部进行操作。之后，您可以使用 .find() 命令（而不是 cy.get()）来定位 Shadow DOM 内部的元素。

示例代码

假设我们有一个 Web 页面，其中包含一个自定义组件 array-account-enroll，而 firstName 输入框位于其 Shadow DOM 内部。以下是使用 .shadow() 命令进行定位的 Cypress 测试代码：

describe('Verify identity data within Shadow DOM', () => {
  it('Successfully finds and interacts with form elements in Shadow DOM', function () {
    // 访问目标页面
    cy.visit('https://whitelabel.sandbox.array.io/signup?platform=v3');

    // 1. 定位 Shadow Host 元素
    // 'array-account-enroll' 是承载 Shadow DOM 的自定义元素标签
    cy.get('array-account-enroll')
      // 2. 使用 .shadow() 命令进入 Shadow DOM 内部
      .shadow()
      // 3. 在 Shadow DOM 内部使用 .find() 定位目标元素
      .find('input[name="firstName"]')
      // 4. 对定位到的元素进行操作，例如输入文本
      .type('John')
      .should('h*e.value', 'John');

    // 可以继续定位其他 Shadow DOM 内部的元素
    cy.get('array-account-enroll')
      .shadow()
      .find('input[name="lastName"]')
      .type('Doe')
      .should('h*e.value', 'Doe');

    // 如果有按钮也在 Shadow DOM 内部，同样可以定位并点击
    // cy.get('array-account-enroll').shadow().find('button[type="submit"]').click();
  });
});

在上述代码中：

• cy.get('array-account-enroll') 定位了 Shadow Host 元素。
• .shadow() 命令将 Cypress 的查询范围切换到 array-account-enroll 元素的 Shadow Tree 内部。
• .find('input[name="firstName"]') 则在 Shadow Tree 内部查找名为 firstName 的输入框。

注意事项与最佳实践

1. 识别 Shadow Host： 正确识别 Shadow Host 是使用 .shadow() 的第一步也是最关键的一步。通常，Shadow Host 是一个自定义元素（如 ）或具有 shadowRoot 属性的常规元素。您可以使用浏览器的开发者工具来检查元素结构，确认哪个元素是 Shadow Host。
2. .shadow() 只能在 Shadow Host 上调用： 确保您在 .shadow() 命令之前定位的元素确实是一个 Shadow Host。如果在非 Shadow Host 元素上调用 .shadow()，Cypress 将会报错。
3. 链式调用 find()： 一旦进入 Shadow DOM，您应该使用 .find() 命令来定位内部元素，而不是 cy.get()。cy.get() 总是从根 DOM 开始查询，而 .find() 是从当前主题（即 Shadow Root）开始查询。
4. 多次进入 Shadow DOM： 如果页面中有多个独立的 Shadow DOM 实例，或者您需要操作不同 Shadow DOM 中的元素，您可能需要多次重复 cy.get('shadow-host').shadow().find('element') 的模式。
5. 调试技巧： 在 Cypress 测试运行时，打开浏览器开发者工具，检查元素的 DOM 结构。带有 #shadow-root 标记的元素就是 Shadow Host。展开它，您就能看到 Shadow DOM 内部的元素结构。这对于编写正确的选择器非常有帮助。

总结

处理 Shadow DOM 是 Cypress 高级测试场景中常见的挑战。通过理解 Shadow DOM 的封装特性以及 Cypress 提供的 .shadow() 命令，测试工程师可以有效地穿透 Shadow DOM 边界，精准定位并与内部元素进行交互。遵循先定位 Shadow Host、再使用 .shadow() 进入，最后用 .find() 定位内部元素的策略，将确保您的 Cypress 测试在面对复杂 Web 组件时依然保持高效和稳定。

以上就是Cypress 测试中 Shadow DOM 元素定位策略与实践的详细内容，更多请关注其它相关文章！

# javascript  # java  # 浏览器  # 工具  # 栈  # css  # 网络推广软文网站哪个好  # 河南品质网站建设市面价  # 杭州外包seo服务  # 漳州网站关键词排名推广  # 抖音可以做seo公司  # 国外客户推广网站  # 新市区网站推广怎么选  # 汽车后市场营销推广  # 标准网站建设耗材  # 宁夏关键词排名怎样做  # 是从  # 单选框  # 是一个  # 自定义  # 输入框  # 您可以  # 选择器  # 小爱  # 链式  # 表单  # 封装性 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： C++如何生成随机数_C++ random库使用方法与范围设置  b站如何看历史记录_b站观看历史找回方法  可靠CSGO开箱平台解析 CSGO开箱网合集  qq邮箱发邮件给国外发不出去_QQ邮箱国际邮件发送失败原因与解决  J*a应用集成GitHub CLI与API认证指南  谷歌邮箱网页版官方页面入口 谷歌邮箱网页端快速访问  J*a递归快速排序中静态变量导致数据累积的陷阱与解决方案  德邦快递查询平台 德邦快递物流信息查询入口  Centos/Linux 系统下安装 composer 的完整步骤  押井守高度称赞《辐射4》：玩了八年都停不下来！  怎么去除衣服上的口红印_生活小妙招教你用酒精轻松擦除  J*aScript数组对象转换：按指定键分组与值收集  如何优雅地扩展SprykerGlue后端API授权逻辑，使用spryker/glue-backend-api-application-authorization-connector-extension  生成rdflib自定义SPARQL函数：参数匹配与实践指南  支付宝碰一碰设备是REDMI手机吗 博主拆机辟谣：处理器、内存都不一样  sublime怎么覆盖插件的默认快捷键_sublime快捷键优先级与设置  妖精动漫免费平台 妖精动漫官网资源观看网址  提升Kafka消费者健壮性：会话超时处理与消息处理语义  百度网盘网页版入口 百度网盘网页版官方登录网址  漫画星球免费下拉式入口 漫画星球免费漫画在线阅读网站  Python实现多节点属性重叠度分析教程  如何将HTML表格多行数据保存到Google Sheet  大象笔记网页版入口 印象笔记网页版登录入口  qq游戏手机版下载安装_qq游戏移动端入口  漫蛙2正版漫画站 漫蛙2网页版快速访问入口  拼多多视频播放卡顿如何处理 拼多多视频播放优化技巧  Yandex官方入口网址 Yandex俄罗斯搜索引擎最新在线地址  J*aScript中localStorage数据的获取、清洗与格式化教程  c++中为什么推荐使用using替代typedef_c++现代化类型别名  红果短剧网页版官网入口 官方最新网址发布  J*aScript中向JSON对象添加新属性的正确姿势  Android Studio计算器C键逻辑错误排查与修复：条件判断优化指南  LINUX怎么设置定时任务_LINUX crontab配置教程  创客贴用户入口官网登录 创客贴网页版电脑版系统  QQ邮箱登录平台入口 QQ邮箱网页版邮箱官方入口  内存检查：在VS Code中调试C++时的内存视图  微博网页版直接访问 微博网页版账号管理快速入口  Golang如何优雅处理error_Golang error处理最佳实践总结  Bilibili动漫最新防封地址发布-Bilibili动漫2025年最稳正版入口推荐  晋江读书网页版在线登录 晋江读书电脑版官网  火锅吃太多会怎样 火锅吃太多会上火吗  Win11怎么合并任务栏图标 Win11开启任务栏合并减少图标占空间【方法】  铁路12306官网网页端快速入口 铁路12306官方首页登录教程  Win11怎么查看显卡显存 Win11显示适配器属性及专用视频内存查询  qq游戏网页版直接玩_qq游戏免下载快速入口  html网页设计源代码怎么运行_运行html网页设计源代码步骤【指南】  Pandas DataFrame 高效批量赋值：告别循环与笛卡尔积误区  J*a里如何实现线程安全的懒加载单例_懒加载单例实现方法解析  Google翻译怎么语音输入_Google翻译语音输入功能使用与设置方法  MinIO大规模对象列表性能瓶颈深度解析与外部元数据管理策略