无法以iFrame为根元素创建XPath定位器的技术问题咨询

DOM层级的本质隔离 #

• iframe标签本身是父页面DOM树中的普通元素，但其内部加载的文档内容属于独立的Document实例，和父页面DOM不存在原生的父子节点从属关系
• 浏览器开发者工具中把iframe内部#document缩进展示在iframe标签下方，只是调试工具做的可视化关联，不代表内部节点属于iframe标签的后代节点
• 同源安全策略强制要求不同文档上下文的DOM完全隔离，XPath作为DOM查询语法，必须严格遵守这个边界规则

XPath查询的作用域限制 #

• 所有XPath表达式的遍历范围，严格绑定到执行查询时所处的文档上下文，不会自动跨文档边界穿透
• 当你在父页面上下文里把iframe节点设为XPath根节点时，XPath的轴遍历只会查找父页面DOM树中iframe节点的后代节点——而iframe在父DOM树中是空元素，没有任何子节点，自然无法匹配到内部加载的元素
• 不存在任何XPath语法可以在单个文档上下文里直接穿透iframe边界查询内部元素，这不是写法错误，是底层规范限制

精准定位不同iFrame内同名元素的正确逻辑 #

你已经明确知晓交互前需要切换帧上下文，这里对应定位逻辑做明确说明：
当你通过帧切换操作把当前DOM上下文切换到目标iframe对应的contentDocument后，XPath查询会直接在该iframe的独立DOM树内执行，两个iframe的查询上下文完全独立，哪怕内部元素ID、类名、结构完全一致，也不会出现跨帧匹配错误的问题，不需要在XPath表达式里额外关联外层iframe节点。

关联DOM结构参考 #

<div id="framesWrapper">
    <div id="frame1Wrapper">
        <iframe src="/sample" id="frame1" width="500px" height="350px"></iframe>
        <!-- 以下为frame1内部独立文档内容，不属于父页面DOM树 -->
        #document
            <DOCTYPE hmtl>
            <html>
                <head>...</head>
                <body style="background-color:#a9a9a9" data-new-gr-c-s-check-loaded="14.1065.0" data-gr-ext-installed="">
                    <h1 id="sampleHeading">This is a sample page</h1>
                    <h1 id="sampleHeading">This is a sample page</h1>
                </body>
            </html>
    </div>
    <div id="frame2Wrapper" class="mt-4">
        <iframe src="/sample" id="frame2" width="100px" height="100px"></iframe>
    </div>
</div>

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