自动化测试 / 系统课时
理解窗口句柄
理解窗口句柄
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,最后再显式切回原句柄。
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()预期输出:
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、标题或页面元素确认目标,而不是按列表位置猜测。