自动化测试 / 系统课时

编写参数化测试

编写参数化测试

参数化测试把“测试步骤相同、输入与期望不同”的场景压缩成一份测试逻辑,让 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=...) 会把业务含义写进测试名称。

python
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

预期结果

text
pytest 会生成 3 条独立测试实例,分别对应 valid-admin、wrong-password、unknown-user。

保存为 test_login_params.py 后执行:

bash
python -m pytest -q test_login_params.py

预期输出

text
...                                                                      [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 组合,而不是机械相乘所有维度。参数化的验收标准很简单:每组数据都应能单独命名、单独失败、单独重跑,并且测试函数本身不需要因为某组数据改变执行流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写参数化测试

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

登录哪都通