自动化测试 / 系统课时

截取页面截图

截取页面截图

截图最适合用来保留失败现场、页面状态和关键元素证据。本课使用 Selenium 4 的 Python 绑定,分别保存当前浏览器窗口截图与单个元素截图,并检查文件是否真的写入磁盘。

学习目标

  • 使用 save_screenshot() 保存当前浏览器窗口图像。
  • 使用 WebElement.screenshot() 只截取指定元素。
  • 在测试脚本中检查截图文件是否成功生成。

保存当前窗口截图

driver.save_screenshot(path) 会把当前窗口截图写成 PNG 文件,并返回布尔值表示写入是否成功。它不是跨浏览器统一的“整页长截图”接口;需要完整页面时,应先确认所用浏览器驱动是否支持对应能力。

下面的完整示例会创建 artifacts 目录,打开示例页面,同时保存窗口截图和标题元素截图。文件名固定,便于在 CI 中作为测试产物收集。

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

预期输出

text
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 只保证对当前浏览上下文截图,实际覆盖范围受驱动实现影响;测试证据通常只需要失败时可见区域和关键元素,要求整页时应使用浏览器特定能力并单独验证结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

截取页面截图

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

登录哪都通