自动化测试 / 系统课时
截取页面截图
截取页面截图
截图最适合用来保留失败现场、页面状态和关键元素证据。本课使用 Selenium 4 的 Python 绑定,分别保存当前浏览器窗口截图与单个元素截图,并检查文件是否真的写入磁盘。
学习目标
- 使用
save_screenshot()保存当前浏览器窗口图像。 - 使用
WebElement.screenshot()只截取指定元素。 - 在测试脚本中检查截图文件是否成功生成。
保存当前窗口截图
driver.save_screenshot(path) 会把当前窗口截图写成 PNG 文件,并返回布尔值表示写入是否成功。它不是跨浏览器统一的“整页长截图”接口;需要完整页面时,应先确认所用浏览器驱动是否支持对应能力。
下面的完整示例会创建 artifacts 目录,打开示例页面,同时保存窗口截图和标题元素截图。文件名固定,便于在 CI 中作为测试产物收集。
from pathlib import Path
from selenium import webdriver
from selenium.webdriver.common.by import By
def main():
output_dir = Path("artifacts")
output_dir.mkdir(parents=True, exist_ok=True)
# 所有截图集中写入同一产物目录,便于 CI 收集。
driver = webdriver.Chrome()
try:
driver.get("https://example.com")
page_file = output_dir / "page.png"
element_file = output_dir / "heading.png"
# 窗口截图与元素截图都返回布尔值,可直接用于写入检查。
page_ok = driver.save_screenshot(str(page_file))
heading = driver.find_element(By.TAG_NAME, "h1")
element_ok = heading.screenshot(str(element_file))
print(f"page_saved={page_ok}")
print(f"element_saved={element_ok}")
print(f"files_exist={page_file.exists() and element_file.exists()}")
finally:
# 即使截图或定位失败,也要结束会话,避免残留浏览器进程。
driver.quit()
if __name__ == "__main__":
main()预期输出
page_saved=True
element_saved=True
files_exist=True若驱动、目录权限和页面加载正常,应得到 artifacts/page.png 与 artifacts/heading.png 两个 PNG 文件;实际图片尺寸会随浏览器窗口大小和页面布局变化。
只截取指定元素
元素截图适合按钮、错误提示、验证码容器或价格卡片等局部证据。定位元素后直接调用 element.screenshot("name.png"),截图区域会按元素当前渲染边界裁切,因此应先确保元素已经出现且未被动画或遮罩覆盖。
常见做法是先等待元素进入可见状态,再截图;如果页面有固定顶部栏遮挡目标元素,可先用 scrollIntoView() 或 Selenium 的滚动能力把目标移到可视区域,再执行截图。不要用坐标手工裁切代替元素截图,否则窗口尺寸变化后很容易截错位置。
让截图适合测试取证
自动化项目中不要反复覆盖同一个 screenshot.png。更实用的命名方式是把用例名、阶段和唯一标识写进文件名,例如 login-invalid-password-<ID>.png;<ID> 可以由测试框架生成,避免并发执行时互相覆盖。
截图目录也应单独管理,例如统一放在 artifacts/screenshots。CI 任务失败后上传该目录,调试时就能把日志、报错堆栈和截图对应起来。截图包含账号、订单号等敏感信息时,应在上传测试产物前确认访问权限和保留周期。
处理截图失败
save_screenshot() 返回 False 或没有生成文件时,先检查目标目录是否存在且可写,再确认 WebDriver 会话仍然存活。若页面正在跳转或窗口已经被关闭,应先稳定页面状态再截图。
另一个常见误区是把“当前窗口截图”理解为完整网页截图。标准 Selenium API 只保证对当前浏览上下文截图,实际覆盖范围受驱动实现影响;测试证据通常只需要失败时可见区域和关键元素,要求整页时应使用浏览器特定能力并单独验证结果。