document.querySelector可定位元素但cy.get无法查找Dynamics页面控件问题

问题原因及解决方案 #

1. 优先排查iframe上下文问题 #

Microsoft Dynamics NAV Business Central 的Web客户端默认会把业务操作区域的内容渲染在独立iframe中，你在浏览器控制台执行document.querySelector能找到元素，是因为浏览器控制台默认选中了对应iframe的执行上下文，而Cypress默认只会查询顶层页面的DOM，不会自动进入iframe查找元素。
解决方法：先定位到承载业务内容的iframe，再在iframe内部查询元素：

// 先获取iframe的body上下文，再执行元素查找
cy.get('iframe') // 如果页面有多个iframe，可以加类名或其他属性缩小范围
  .its('0.contentDocument.body')
  .should('not.be.empty')
  .within(() => {
    // 此处所有查询都会在iframe内部执行
    cy.get('[aria-label^="Paketverfolgungsnr."]').should('exist')
    // 也可以正常查询文本输入框
    cy.get('input[type="text"]').should('have.length.gt', 0)
  })

2. 排查Shadow DOM穿透问题 #

Dynamics BC的很多输入控件是基于Web Component开发的，会嵌套在Shadow Root中，Cypress默认不会穿透Shadow DOM查询元素。
解决方法：

• 全局开启：在cypress.config.js配置文件中添加includeShadowDom: true，所有查询默认自动穿透Shadow DOM
• 单次查询开启：在查询语句中添加配置参数

cy.get('[aria-label^="Paketverfolgungsnr."]', { includeShadowDom: true })

3. 选择器写法及等待优化 #

你示例中的选择器不需要做HTML转义，直接用单双引号嵌套即可，另外BC控件多为异步渲染，可以适当延长超时时间等待元素加载：

// 最长等待10秒，直到元素出现
cy.get('[aria-label^="Paketverfolgungsnr."]', { timeout: 10000 }).should('be.visible')

内容的提问来源于stack exchange，提问作者Andreas