自动化测试 / 系统课时
设置窗口尺寸
设置窗口尺寸
浏览器窗口大小会直接影响响应式布局、菜单折叠和截图结果。Selenium 可以设置窗口宽高与屏幕位置,也能最大化或最小化当前窗口。本节使用固定像素尺寸完成一次可重复验证,并说明窗口尺寸、网页视口和桌面环境之间的差异。
学习目标
- 使用
set_window_size、set_window_position设置浏览器窗口。 - 使用
get_window_size、get_window_position验证实际结果。 - 正确处理最大化、最小化以及不同运行环境造成的尺寸差异。
精确设置尺寸和位置
set_window_size(width, height) 接收像素宽高,set_window_position(x, y) 设置窗口左上角在屏幕中的位置。下面把窗口设为 1024×768,并请求移动到坐标 (40, 60),随后读取实际值进行验证。
from selenium import webdriver
driver = webdriver.Chrome()
try:
# 固定窗口尺寸,便于响应式页面和截图测试复现。
driver.set_window_size(1024, 768)
driver.set_window_position(40, 60)
size = driver.get_window_size()
position = driver.get_window_position()
print(f"size: {size['width']}x{size['height']}")
print(f"position: {position['x']},{position['y']}")
finally:
driver.quit()预期输出
size: 1024x768
position: <ACTUAL_X>,<ACTUAL_Y><ACTUAL_X> 和 <ACTUAL_Y> 在普通桌面环境中通常接近请求的 40,60,但窗口管理器、多显示器布局或屏幕边界可能调整实际坐标。因此尺寸适合做精确验证,窗口位置更适合读取实际值后记录,而不是在所有机器上强制断言完全相同。
区分窗口尺寸与网页视口
WebDriver 的窗口管理 API 操作的是浏览器顶层窗口。网页 CSS 使用的布局视口则可通过 JavaScript 的 window.innerWidth 和 window.innerHeight 获取,两者可能因为标题栏、标签栏等浏览器界面而不同。因此设置 1024×768 后,不应直接假定网页视口也恰好是 1024×768。
需要验证响应式断点时,可以先固定 WebDriver 窗口,再用 driver.execute_script("return [window.innerWidth, window.innerHeight]") 读取实际视口。若产品在 768 px、1024 px 等 CSS 断点切换布局,应以实际视口宽度判断,而不是只看 get_window_size()。
| 检查对象 | 推荐方式 | 适合用途 |
|---|---|---|
| 浏览器窗口宽高 | get_window_size() |
固定测试运行环境 |
| 窗口屏幕坐标 | get_window_position() |
多窗口排列与排障 |
| 页面布局视口 | window.innerWidth、window.innerHeight |
响应式断点验证 |
最大化、最小化与恢复
需要模拟用户把浏览器铺满桌面时,可以调用 driver.maximize_window();需要最小化当前窗口时使用 driver.minimize_window()。这两种状态都由操作系统窗口管理器参与处理,因此不要把最大化后的具体宽高写成跨机器固定值。
从最大化或最小化状态回到确定尺寸时,可以再次调用 driver.set_window_size(1024, 768)。实际自动化项目中,若目标是稳定截图或复现响应式布局,固定尺寸通常比最大化更可控,因为 CI 机器、远程桌面和开发者显示器的可用屏幕尺寸可能不同。
用一个矩形同时管理窗口
如果同时需要读取窗口的位置和尺寸,可以使用 driver.get_window_rect(),返回包含 x、y、width、height 的字典。需要一次设置四个值时,则可以使用 driver.set_window_rect(x=40, y=60, width=1024, height=768),比连续调用位置和尺寸方法更集中。
测试套件中建议统一选定一组固定尺寸,例如桌面场景使用 1280×900,再在每条依赖响应式布局的测试开始前设置。执行后读取 get_window_rect() 做一次检查;如果宽高明显偏离请求值,再排查浏览器启动参数、无头模式、容器显示服务或操作系统窗口限制,而不是直接修改页面断言。