自动化测试 / 系统课时

理解窗口句柄

理解窗口句柄

Selenium 操作多个标签页或浏览器窗口时,不靠页面标题识别控制对象,而是靠窗口句柄定位浏览上下文。掌握句柄后,你可以可靠地保存原窗口、切到新窗口,再在关闭后回到正确位置。

学习目标

  • 区分当前窗口句柄与全部窗口句柄,知道句柄不能当业务编号使用。
  • 使用 current_window_handle、window_handles 与 switch_to.window() 完成切换。
  • 正确处理 close() 后的上下文恢复,避免继续操作已经关闭的窗口。

句柄对应的是浏览上下文

以下 API 适用于 Selenium 4 的 Python 绑定。driver.current_window_handle 返回当前受控标签页或窗口的句柄字符串,driver.window_handles 返回当前会话里所有可用句柄。句柄值由驱动生成,应当视为不透明标识,不解析内容,也不假设每次运行相同。

操作 Python API 可直接检查的结果
读取当前上下文 driver.current_window_handle 得到一个非空字符串
读取全部上下文 driver.window_handles 得到句柄列表
切换上下文 driver.switch_to.window(handle) 后续查找、URL、标题都来自目标窗口

窗口句柄与当前浏览上下文的对应关系

窗口句柄只负责“指向哪个浏览上下文”,不会自动证明页面已经加载完成。因此切换后仍要按业务条件等待标题、URL 或目标元素出现,而不是把“切换成功”和“页面可操作”当成同一件事。

读取、创建并切回窗口

下面示例先保存原句柄,再创建一个新标签页。switch_to.new_window("tab") 在 Selenium 4 中会创建并立即切到新标签页,因此可以直接读取新的 current_window_handle,最后再显式切回原句柄。

python
from selenium import webdriver

driver = webdriver.Chrome()

try:
    driver.get("https://www.selenium.dev/")
    original = driver.current_window_handle
    print("original:", original)

    # Selenium 4:创建新标签页后,当前上下文会立即变成新标签页。
    driver.switch_to.new_window("tab")
    new_handle = driver.current_window_handle

    print("handle_count:", len(driver.window_handles))
    print("new_handle:", new_handle)

    # 使用保存下来的原句柄恢复控制权。
    driver.switch_to.window(original)
    print("back_to_original:", driver.current_window_handle == original)
finally:
    driver.quit()

预期输出:

text
original: <ID>
handle_count: 2
new_handle: <ID>
back_to_original: True

<ID> 是每次会话动态生成的句柄,实际值可能不同。真正应验证的是句柄非空、数量从 1 变为 2,以及切回后当前句柄等于最初保存的 original。

关闭窗口后必须重新指定上下文

driver.close() 只关闭当前标签页或窗口,driver.quit() 则结束整个 WebDriver 会话并关闭该会话管理的全部浏览上下文。测试中关闭当前窗口后,应立即切到仍然存在的有效句柄,否则下一条窗口相关命令可能抛出 NoSuchWindowException。

场景 正确动作 常见错误
只关当前标签页 driver.close() 用 quit() 导致整个会话结束
关闭后继续测试 driver.switch_to.window(original) 继续在已关闭上下文查找元素
测试彻底结束 driver.quit() 只 close(),遗留其他窗口

实战里可以把原句柄保存在变量 original 中,并在关闭临时窗口后恢复它。不要在代码里硬编码某个句柄字符串,因为新会话会生成新的值。

不要把句柄列表下标当成业务规则

window_handles[0] 常常碰巧是最早打开的窗口,但测试逻辑不应依赖“第二个元素一定是新窗口”这种假设。更稳妥的做法是在触发新窗口前保存一组旧句柄,触发后等待数量变化,再用集合差集找出新增句柄。

当一次操作只会新增一个窗口时,检查条件应当是“新增句柄集合长度等于 1”。如果一次动作可能打开多个窗口,则应逐个切换后根据明确的 URL、标题或页面元素确认目标,而不是按列表位置猜测。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解窗口句柄

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

登录哪都通