自动化测试 / 系统课时

设置窗口尺寸

设置窗口尺寸

浏览器窗口大小会直接影响响应式布局、菜单折叠和截图结果。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),随后读取实际值进行验证。

python
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()

预期输出

text
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() 做一次检查;如果宽高明显偏离请求值,再排查浏览器启动参数、无头模式、容器显示服务或操作系统窗口限制,而不是直接修改页面断言。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置窗口尺寸

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

登录哪都通