playwright中iframe定位需显式使用frame_locator()逐层链式调用，不可跳过中间层级；推荐用name/id定位，动态iframe需配合等待机制，跨域iframe内容不可访问。
Playwright 中 iframe 的定位逻辑和嵌套访问方式
Playwright 不像 Selenium 那样默认支持“切换 iframe 上下文”，它要求你显式地通过 frame_locator() 定位到目标 iframe，再在其内部继续查找元素。多层嵌套时，必须逐层调用 frame_locator()，不能跳过中间层级。
常见错误是试图用 page.frame("name") 或 page.frames[0] 直接取子 iframe —— 这些方法只返回顶层 iframe 列表，无法访问嵌套在另一个 iframe 内的 iframe。
-
frame_locator()返回的是FrameLocator对象，不是实际的Frame实例，它支持链式调用（如.frame_locator().frame_locator().get_by_text()） - iframe 的 name、id、title 属性或 CSS 选择器都可作为定位依据，但推荐优先用
name或id，避免因 DOM 动态加载导致选择器失效 - 如果 iframe 是动态插入的（比如由 JS 创建），需配合
wait_for_timeout()或expect(...).to_be_visible()确保其已挂载
如何链式定位三层嵌套 iframe 并点击按钮
假设页面结构为：主页面 → iframe#main → iframe[name="sub"] → iframe[data-role="editor"]，最终要点击其中的 button#save。
正确写法是逐层构造 FrameLocator，最后才执行动作：
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
await page
.frame_locator("#main")
.frame_locator('iframe[name="sub"]')
.frame_locator('iframe[data-role="editor"]')
.get_by_role("button", name="Save")
.click()
注意：所有 frame_locator() 调用都必须基于前一个 locator 的结果，不能从 page 重新开始；否则会回到顶层上下文。
- 若某层 iframe 没有稳定属性，可用
nth()，例如.frame_locator("iframe").nth(1)，但稳定性差，仅作临时调试用 -
get_by_role()和get_by_text()在 iframe 内部仍有效，无需额外切换上下文 - 不建议用
content_frame()手动提取 frame 实例再操作 —— 这种方式容易因异步加载失败而抛TimeoutError
处理 iframe 加载失败或跨域限制的典型报错
运行时可能遇到 TimeoutError: frame was detached 或 Frame is not attached to the page，本质是 iframe 被销毁后 locator 仍在尝试访问。根本原因常是页面重绘、SPA 路由跳转或 iframe 被 JS 移除。
- 避免在 iframe 尚未加载完成时就调用
frame_locator()，应在父级 iframe 渲染后加等待，例如：await page.frame_locator("#main").locator("body").wait_for() - 跨域 iframe（如嵌入第三方 widget）在 Chromium 中默认不可访问内容，会报
Frame does not have a document；此时只能操作外层容器（如点击触发它的按钮），无法读写内部 DOM - Playwright 1.40+ 对跨域 iframe 的支持仍有限，不要依赖
content_frame()获取跨域 frame 的 document
调试嵌套 iframe 的实用技巧
当不确定 iframe 层级或属性时，别靠猜 —— 用 Playwright 自带的调试能力快速验证。
- 启动时加
--browser chromium --slow-motion 500，观察 iframe 是否按预期加载 - 在代码中插入
print([f.name for f in page.frames])查看当前所有 iframe 名称（注意：只含已加载且非跨域的） - 用
page.locator("iframe").all()获取所有 iframe 元素，再逐个检查element.get_attribute("src")或inner_html()辅助判断 - VS Code 中启用 Playwright Inspector（
PWDEBUG=1），悬停在frame_locator()链上可实时高亮对应 iframe 区域
嵌套越深，定位链越脆弱；真正难的不是语法，而是确认每一层 iframe 是否稳定存在、是否同源、是否已完成渲染 —— 这些必须靠日志和 inspector 验证，不能只信 HTML 结构注释。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
