WebDriverIO v7在Chrome v96的Salesforce应用中切换iframe报错求助

这是Chrome v96版本升级后触发的已知兼容性问题，核心触发原因有两个：

• Chrome 96调整了DevTools Protocol（CDP）中帧识别的逻辑，未完成初始化、跨域、隐藏状态的iframe元素引用传递给切换帧接口时，会直接抛出no such frame错误，该逻辑在v95及更早版本中做了兼容处理
• 基于Salesforce Lightning开发的应用会动态插入多个系统级隐藏iframe，Chrome 96调整了DOM节点渲染顺序，你所用的索引xpath(//iframe)[1]会优先匹配到未初始化完成的隐藏系统iframe，而非业务iframe

按优先级从高到低排列：

• 替换索引定位为精准属性定位
  Salesforce Lightning的业务iframe通常会带有可唯一识别的title、data-aura-class等属性，直接通过属性定位可完全规避索引匹配错误的问题，代码示例：

// 替换为实际业务iframe的title值
const targetIframe = await $('iframe[title="业务功能iframe"]')
await browser.switchToFrame(targetIframe)

• 增加iframe加载完成的显式等待
  获取iframe元素后先等待元素可交互再执行切换，避免拿到还未完成初始化的帧元素：

const targetIframe = await $('iframe[title="业务功能iframe"]')
// 等待元素存在、可见
await targetIframe.waitForExist({ timeout: 8000 })
await targetIframe.waitForDisplayed({ timeout: 5000 })
await browser.switchToFrame(targetIframe)

• 优化索引xpath过滤无效帧
  如果必须使用索引定位，调整xpath规则过滤掉Salesforce插入的隐藏、0尺寸系统iframe：

const targetIframe = await $('(//iframe[not(contains(@style,"display:none")) and @width>0 and @height>0])[1]')
await browser.switchToFrame(targetIframe)

• 修正ChromeDriver版本匹配
  必须使用与Chrome版本完全对应的ChromeDriver版本，Chrome v96.0.4664.45需搭配同版本号的ChromeDriver，避免跨版本导致CDP接口不兼容。
• 临时兼容跨域帧策略（仅测试环境使用）
  如果问题是跨域iframe策略限制导致，可在Chrome启动参数中添加--disable-features=IsolateOrigins,site-per-process临时关闭严格的站点隔离策略，该配置不建议在生产验证场景长期使用。

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