自动化测试 / 系统课时

切换 iframe

切换 iframe

页面里的 iframe 是独立的浏览上下文。Selenium 默认只在当前上下文查找元素,所以即使开发者工具能看到 iframe 内按钮,未切换进去时 find_element 仍找不到它。本节用嵌套 iframe 演示进入子框架、返回父级和回到顶层页面的完整路径。

学习目标

  • 使用 switch_to.frame() 进入指定 iframe。
  • 区分 parent_frame() 与 default_content() 的返回范围。
  • 识别“元素存在但当前上下文不对”导致的定位失败。

iframe 改变了元素查找范围

顶层页面、外层 iframe、内层 iframe 各自有独立 DOM。driver.find_element(...) 只搜索 当前浏览上下文,不会自动跨 iframe。进入框架后,顶层页面里的元素也暂时不在当前查找范围内。

当前上下文 能直接定位的元素 不能直接定位的元素
顶层页面 顶层 DOM 元素、iframe 元素本身 iframe 内部元素
外层 iframe 外层 iframe 的 DOM、其中的内层 iframe 顶层页面元素、内层 iframe 内部元素
内层 iframe 内层 iframe 的 DOM 元素 顶层页面与外层 iframe 的普通元素

因此,遇到“元素明明在页面上却报 NoSuchElementException”时,先确认它是否位于 iframe,而不是立即改选择器。

进入、返回父级与回到顶层

switch_to.frame() 可以接收 iframe 的 WebElement、名称或索引。项目代码更推荐先定位 iframe 元素再切换,因为可读性高,也不依赖页面中 iframe 的排列顺序。

顶层页面与嵌套 iframe 的上下文切换关系

python
from selenium import webdriver
from selenium.webdriver.common.by import By

driver = webdriver.Chrome()

try:
    driver.get(
        "data:text/html,"
        "<title>Frame Demo</title>"
        "<h1 id='top'>Top</h1>"
        "<iframe id='outer'></iframe>"
    )

    # 在同源 about:blank iframe 中构造两层可测试 DOM。
    driver.execute_script(
        '''
        const outer = document.getElementById("outer");
        outer.contentDocument.body.innerHTML =
          '<h2 id="outer-title">Outer</h2><iframe id="inner"></iframe>';
        const inner = outer.contentDocument.getElementById("inner");
        inner.contentDocument.body.innerHTML =
          '<button id="inside">Inside</button>';
        '''
    )

    outer = driver.find_element(By.ID, "outer")
    driver.switch_to.frame(outer)
    print(driver.find_element(By.ID, "outer-title").text)

    inner = driver.find_element(By.ID, "inner")
    driver.switch_to.frame(inner)
    print(driver.find_element(By.ID, "inside").text)

    # 只返回一级:Inner -> Outer。
    driver.switch_to.parent_frame()
    print(driver.find_element(By.ID, "outer-title").text)

    # 无论当前嵌套多深,都直接返回顶层页面。
    driver.switch_to.default_content()
    print(driver.find_element(By.ID, "top").text)
finally:
    driver.quit()

预期输出

text
Outer
Inside
Outer
Top

这段输出同时验证了四个上下文位置:先进入外层,再进入内层,随后退回父级,最后返回顶层。

动态 iframe 要先等待再切换

异步页面常先插入 iframe 容器,再晚几百毫秒加载可用的 frame。此时不要用固定 sleep(2) 猜时间。Selenium 提供 expected_conditions.frame_to_be_available_and_switch_to_it,可把“等待可用”和“切换”合并成一次操作。

例如支付 iframe 的定位器是 (By.ID, "payment-frame") 时,可以用 WebDriverWait(driver, 10) 最多等待 10 秒,并等待 EC.frame_to_be_available_and_switch_to_it((By.ID, "payment-frame"))。条件成功后,当前上下文已经在该 iframe 内,不需要再调用一次 switch_to.frame()。

常见失败与修正

如果 switch_to.frame() 抛出 NoSuchFrameException,先检查传入的 frame 是否仍存在,以及当前是否已经处在错误的父级上下文。嵌套 iframe 必须逐层进入:先切到 outer,才能在 outer 的 DOM 中定位 inner。

如果定位顶层元素时得到 NoSuchElementException,而刚刚操作过 iframe,先执行 driver.switch_to.default_content() 再查找。若只需要从内层回到外层,不要用 default_content(),否则会一次跳回顶层;应使用 driver.switch_to.parent_frame()。

实践中可以把“进入 frame”和“退出 frame”成对组织:进入支付 frame 完成输入后立即回到顶层,再进行页面按钮点击。这样能把上下文范围限制在最短步骤内,减少后续定位器因遗留 frame 状态而失败。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

切换 iframe

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通