Cypress定位DOM内嵌入文档中Release Notes文本的问题求助

问题根因 #

• 你要找的「Release Notes」文本位于<object>标签加载的外部HTML独立文档内，属于嵌套浏览上下文，既不属于主DOM树，也不是Shadow DOM结构，所以你配置的includeShadowDom: true不生效，直接在主DOM查询肯定无法命中。
• 之前取.release-notes和object节点的text()为空，是因为文本内容都存在于<object>加载的内部文档里，不在这两个节点本身的文本节点中。
• 直接全局搜h1:contains("Release Notes")失败，是因为搜索范围仅限主DOM，没有覆盖到<object>的内部文档。

可行代码方案 #

先等待<object>加载完成，获取其内部文档对象后再做查询，代码示例如下：

cy.get('object.release-notes-object')
  // 先确认object元素可见
  .should('be.visible')
  // 获取object节点对应的内部文档对象
  .its('0.contentDocument')
  // 确认内部文档已成功加载
  .should('exist')
  .then(innerDoc => {
    // 方式1：校验内部文档的h1是否包含目标文本
    cy.wrap(innerDoc)
      .find('h1')
      .should('contain.text', 'Release Notes')

    // 方式2：直接校验内部文档整体包含目标文本
    cy.wrap(innerDoc.body)
      .should('contain', 'Release Notes')
  })

常见注意点 #

• 如果上述代码出现内部文档跨域报错，需要在cypress.config.js（或旧版cypress.json）中添加chromeWebSecurity: false配置，关闭跨域安全限制即可。
• 不要直接在主DOM做全局文本搜索，嵌套上下文的内容不会被主DOM的查询命中。
• 你之前写的cy.get('body').should('contains', "Release Notes")还有语法错误，Cypress的包含文本断言词是contain不是contains，即使节点正确也会触发报错。

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