自动化测试 / 系统课时

切换新标签页

切换新标签页

新标签页最容易出错的地方不是 switch_to.window() 本身,而是切换得太早或拿错句柄。本篇用可运行示例完成“记录旧句柄、等待新标签页、找出新增句柄、切换、关闭并返回”的完整链路。

学习目标

  • 在触发新标签页前保存原句柄与旧句柄集合。
  • 使用显式等待确认新浏览上下文已经出现,再计算新增句柄。
  • 切换后用 URL 等业务条件验收,并在关闭新标签页后返回原标签页。

先区分主动创建与页面触发

如果测试代码自己创建标签页,Selenium 4 可以直接调用 driver.switch_to.new_window("tab"),该调用会自动切到新标签页。若新标签页由页面点击、支付跳转或第三方登录触发,就必须等待句柄集合变化后再定位目标句柄。

场景 推荐做法 是否需要自己找新增句柄
测试主动新建标签页 switch_to.new_window("tab") 否,调用后已经切换
点击链接打开新标签页 记录旧集合并等待数量变化 是
一次可能打开多个页面 逐个候选按 URL、标题或元素确认 是

业务自动化最常见的是第二种,因此后面的主示例采用“页面触发新标签页”的模式,而不是依赖固定下标。

等待新标签页再做集合差集

下面示例在一个内嵌测试页中点击按钮,通过 window.open(..., "_blank") 打开 Selenium 官方表单页。先保存旧句柄集合,再等待窗口数变为 2,最后用集合差集取得唯一新增句柄并切换。

python
from urllib.parse import quote

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

driver = webdriver.Chrome()

try:
    html = '''
    <!doctype html>
    <button id="open"
      onclick="window.open('https://www.selenium.dev/selenium/web/web-form.html', '_blank')">
      Open
    </button>
    '''
    driver.get("data:text/html;charset=utf-8," + quote(html))

    original = driver.current_window_handle
    before = set(driver.window_handles)

    # 由页面动作触发新浏览上下文,再显式等待句柄数量变化。
    driver.find_element(By.ID, "open").click()
    WebDriverWait(driver, 10).until(EC.number_of_windows_to_be(2))

    new_handles = set(driver.window_handles) - before
    assert len(new_handles) == 1
    new_handle = new_handles.pop()

    driver.switch_to.window(new_handle)
    WebDriverWait(driver, 10).until(lambda d: "selenium.dev" in d.current_url)

    print("handle_count:", len(driver.window_handles))
    print("switched:", driver.current_window_handle == new_handle)
    print("target_url_ok:", "selenium.dev" in driver.current_url)

    driver.close()
    driver.switch_to.window(original)
    print("back_to_original:", driver.current_window_handle == original)
finally:
    driver.quit()

预期输出:

text
handle_count: 2
switched: True
target_url_ok: True
back_to_original: True

这里的 10 秒是显式等待上限,不代表每次都会等待满 10 秒;条件满足后会立即继续。如果运行环境网络较慢,可以提高等待上限,但不要用固定 sleep(10) 代替状态检查。

新标签页从出现到切换再返回的状态流程

不要用固定下标猜新标签页

driver.window_handles[-1] 在只有两个窗口的简单演示里经常可用,但它把“列表顺序”误当成了业务保证。更可靠的判定是 after - before,因为它直接表达“这次操作新增了哪个句柄”,也便于对异常数量做断言。

如果预期只新增 1 个标签页,就像主示例一样执行 assert len(new_handles) == 1。若断言得到 0,通常说明页面没有成功打开新上下文或等待条件不对;若大于 1,则应检查页面是否同时触发了广告页、认证页或其他弹窗,并按 URL 或元素确认真正目标。

切换成功后还要验证页面身份

句柄切换成功只说明 WebDriver 已经控制另一个浏览上下文,不代表它就是目标业务页面。至少再验证一个稳定条件,例如 URL 主机名、页面标题,或目标页独有元素;对于动态单页应用,优先等待具体元素而不是只检查标题。

主示例先验证 current_window_handle == new_handle,再等待 current_url 包含 selenium.dev,这两层检查分别确认“控制对象正确”和“目标导航已发生”。真实项目中可以把第二层替换成登录成功标记、订单号区域或支付结果元素。

关闭新标签页后回到原页面

关闭新标签页的安全顺序是:保存 original、切到新句柄、完成断言、执行 driver.close()、再调用 driver.switch_to.window(original)。如果省略最后一步,驱动仍指向已经关闭的浏览上下文,后续定位元素时就会失败。

多标签页测试结束前还应检查 len(driver.window_handles) 是否回到预期数量。若原页面本来只有一个标签页,那么关闭临时页并切回后数量应重新变为 1,这个检查能快速发现测试遗留窗口和清理逻辑缺失。

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

目录与阅读设置

阅读设置

17

记录一个想法

切换新标签页

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

登录哪都通