自动化测试 / 系统课时
编写参数化测试
编写参数化测试
参数化测试把“测试步骤相同、输入与期望不同”的场景压缩成一份测试逻辑,让 pytest 为每组数据生成独立用例。它最适合登录、搜索、表单校验等重复流程,并能让失败直接定位到具体数据组,而不是复制多份几乎相同的 Selenium 代码。
学习目标
- 使用
pytest.mark.parametrize为同一 Selenium 流程提供多组输入。 - 为每组数据设置可读的
id,让测试报告能直接定位失败样本。 - 判断什么时候应该参数化,什么时候应拆成不同测试流程。
先确认只有数据在变化
参数化前先检查三件事:页面入口相同、操作顺序相同、断言结构相同。下面三组登录数据都执行“输入账号密码 → 点击提交 → 检查消息”,因此适合放在同一参数化测试中;如果某组需要验证码或额外跳转,就应拆成另一条测试。
| 用例 ID | 用户名 | 密码 | 期望消息 |
|---|---|---|---|
valid-admin |
admin |
admin123 |
登录成功 |
wrong-password |
admin |
badpass |
凭据错误 |
unknown-user |
nobody |
admin123 |
凭据错误 |
用 parametrize 生成独立 Selenium 用例
下面示例使用 Selenium Python WebDriver 与 pytest 的参数化 API。浏览器页面由本地 data: URL 构造,三组参数都会运行同一套定位和点击逻辑;pytest.param(..., id=...) 会把业务含义写进测试名称。
from urllib.parse import quote
import pytest
from selenium import webdriver
from selenium.webdriver.common.by import By
HTML = """
<form id="login-form">
<input id="username">
<input id="password" type="password">
<button id="submit" type="button">登录</button>
<p id="message"></p>
</form>
<script>
document.getElementById("submit").addEventListener("click", () => {
const user = document.getElementById("username").value;
const password = document.getElementById("password").value;
document.getElementById("message").textContent =
user === "admin" && password === "admin123"
? "登录成功"
: "凭据错误";
});
</script>
"""
@pytest.fixture
def driver():
browser = webdriver.Chrome()
browser.get("data:text/html;charset=utf-8," + quote(HTML))
yield browser
browser.quit()
@pytest.mark.parametrize(
("username", "password", "expected"),
[
pytest.param(
"admin", "admin123", "登录成功", id="valid-admin"
),
pytest.param(
"admin", "badpass", "凭据错误", id="wrong-password"
),
pytest.param(
"nobody", "admin123", "凭据错误", id="unknown-user"
),
],
)
def test_login_message(driver, username, password, expected):
# 每个参数实例都获得独立浏览器,避免表单状态相互污染。
driver.find_element(By.ID, "username").send_keys(username)
driver.find_element(By.ID, "password").send_keys(password)
driver.find_element(By.ID, "submit").click()
actual = driver.find_element(By.ID, "message").text
assert actual == expected预期结果
pytest 会生成 3 条独立测试实例,分别对应 valid-admin、wrong-password、unknown-user。保存为 test_login_params.py 后执行:
python -m pytest -q test_login_params.py预期输出
... [100%]
3 passed in <TIME>s让失败报告能直接定位数据组
参数列表不要只写裸元组,例如 ("admin", "badpass", "凭据错误");数据一多,报告里的索引很难对应业务含义。优先使用 pytest.param(..., id="wrong-password"),并让 ID 描述场景而不是序号。失败时运行 python -m pytest -vv test_login_params.py,报告会直接显示具体参数 ID。
如果同一个参数组合需要额外分支,例如 if username == "admin": 才执行另一套流程,说明测试结构已经不同。此时应拆分测试函数,而不是继续往参数表里塞控制字段,否则参数化会变成隐藏的流程编排。
避免参数组合失控
多个 @pytest.mark.parametrize 装饰器会产生笛卡尔积。假设有 5 种浏览器、8 个账号、6 种语言,全部组合就是 240 次执行;若每次 Selenium 用例平均 8 秒,串行就接近 32 分钟。烟雾测试通常只保留 3~6 组代表性组合,完整回归再扩大覆盖。
当目标是验证明确业务样本时,优先直接列出经过挑选的 pytest.param 组合,而不是机械相乘所有维度。参数化的验收标准很简单:每组数据都应能单独命名、单独失败、单独重跑,并且测试函数本身不需要因为某组数据改变执行流程。