自动化测试 / 系统课时

接入测试框架

接入测试框架

把 Selenium 脚本接入 pytest 后,可以统一完成用例发现、浏览器初始化、失败报告和资源清理。最终目标是让测试只负责操作与断言,而浏览器生命周期交给 fixture 管理,并能用一条命令稳定执行整套 UI 用例。

学习目标

  • 使用 pytest fixture 管理 WebDriver 的创建与关闭
  • 用 pytest 发现并执行 Selenium 测试,同时获得明确的通过或失败结果
  • 配置统一的测试目录、输出格式和异常回溯方式

安装并验证测试依赖

以下做法适用于 Python 3.10+、pytest 8.x 及 Selenium 4.x。Selenium 4.6 及以后通常可由 Selenium Manager 自动处理兼容的浏览器驱动,但本机仍需要安装对应浏览器,例如 Chrome。

先在项目虚拟环境中安装 pytest 与 Selenium:

bash
python -m pip install pytest selenium

预期结果

text
Successfully installed <PACKAGE_LIST>

如果依赖已经存在,pip 可能显示 Requirement already satisfied,这同样表示安装步骤成功。继续执行版本检查,确认当前 Python 环境确实能导入两个包:

bash
python -c "import pytest, selenium; print(pytest.__version__, selenium.__version__)"

预期输出

text
<PYTEST_VERSION> <SELENIUM_VERSION>

版本号会随本机环境变化;若出现 ModuleNotFoundError,优先检查安装依赖和运行 pytest 是否使用了同一个 Python 解释器。

用 fixture 管理浏览器生命周期

pytest fixture 很适合承接 WebDriver 的初始化与销毁。下面的 driver fixture 在每个测试开始前创建无头 Chrome,在测试完成后无论断言是否失败都会执行 quit(),避免遗留浏览器进程。

python
import pytest
from selenium import webdriver
from selenium.webdriver.common.by import By


@pytest.fixture
def driver():
    options = webdriver.ChromeOptions()
    options.add_argument("--headless=new")
    browser = webdriver.Chrome(options=options)
    browser.set_page_load_timeout(10)
    yield browser
    browser.quit()


def test_page_status(driver):
    driver.get(
        "data:text/html,<title>Smoke Test</title>"
        "<h1 id='status'>Ready</h1>"
    )

    assert driver.title == "Smoke Test"
    assert driver.find_element(By.ID, "status").text == "Ready"

将文件保存为 tests/test_smoke.py 后执行:

bash
python -m pytest tests/test_smoke.py -q

预期输出

text
.                                                                        [100%]
1 passed in <TIME>s

<TIME> 是动态值。把 browser.quit() 写在普通测试函数结尾是常见错误:一旦前面的定位或断言抛异常,关闭语句可能根本不会执行;放在 yield fixture 的清理阶段更可靠。

pytest 与 Selenium 从用例收集到浏览器清理的执行流程

固定 pytest 的运行约定

多人项目不要让每个人记一套命令参数。可在项目根目录创建 pytest.ini,统一指定测试目录、简洁输出和短异常回溯,并提前登记 UI 测试常用 marker。

ini
[pytest]
testpaths = tests
addopts = -q --tb=short
markers =
    smoke: critical UI smoke tests
    regression: full regression tests

这是配置文件,不产生独立控制台输出。保存后在项目根目录执行 python -m pytest 即会自动读取配置;验证方法是故意加入一个失败断言,确认报告使用短回溯,而不是完整 Python 调用栈。

用退出码判断自动化结果

pytest 不只给人阅读结果,也通过进程退出码告诉 CI 是否成功。正常全部通过时退出码为 0,存在测试失败时通常为 1,没有收集到测试时为 5;因此流水线无需解析屏幕上的 passed 文本。

可以直接运行测试并让 shell 接收 pytest 的退出状态:

bash
python -m pytest

预期输出

text
.                                                                        [100%]
1 passed in <TIME>s

实际项目接入 GitHub Actions、GitLab CI 或 Jenkins 时,应让测试命令的退出码原样传递给流水线,不要在命令后追加无条件成功的处理。这样断言失败、fixture 初始化失败或浏览器启动异常都会直接阻止测试阶段被误判为成功。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入测试框架

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

登录哪都通