自动化测试 / 系统课时
组织软断言
组织软断言
软断言适合一个页面上有多项彼此独立的验证:某一项失败时先记录问题,继续检查其余项目,最后一次性让用例失败。这样一次运行就能看到完整差异,同时仍把“页面是否能继续操作”这类前置条件保留为硬断言。
学习目标
- 区分硬断言与软断言,知道哪些失败可以继续收集。
- 在 Selenium 用例中实现一个最小软断言收集器,并统一抛出失败。
- 控制软断言范围,避免前置条件失败后继续产生无意义的连锁报错。
将可继续的失败放进收集器
硬断言适合“失败后无法继续”的条件,例如订单详情区根本不存在;软断言适合状态、金额、标签等独立字段。一个实用判断是:失败后还能否可靠找到后续元素。不能,就立即 assert;能,就记录实际值、期望值和检查项名称。
| 检查项 | 建议方式 | 原因 |
|---|---|---|
#summary 是否可见 |
硬断言 | 不可见时后续字段定位没有意义 |
#status 文本 |
软断言 | 状态错误不妨碍继续读取金额 |
#total 文本 |
软断言 | 可与状态失败一起汇总报告 |
在 Selenium 用例中一次收集多个差异
下面示例使用 Selenium 的当前 Python WebDriver API 与 pytest。页面用 data: URL 构造,不依赖外部站点;测试故意把状态和金额的期望值写错,用来确认两个失败会在同一条用例中汇总。
python
from urllib.parse import quote
from selenium import webdriver
from selenium.webdriver.common.by import By
class SoftAssertions:
def __init__(self):
self.failures = []
def equal(self, actual, expected, label):
if actual != expected:
self.failures.append(
f"{label}: actual={actual!r}, expected={expected!r}"
)
def assert_all(self):
if self.failures:
details = "\n".join(
f"{index}. {message}"
for index, message in enumerate(self.failures, start=1)
)
raise AssertionError(
f"{len(self.failures)} 条软断言失败:\n{details}"
)
def test_order_summary():
html = """
<section id="summary">
<h1>订单 1042</h1>
<span id="status">处理中</span>
<strong id="total">$99.00</strong>
</section>
"""
driver = webdriver.Chrome()
soft = SoftAssertions()
try:
driver.get("data:text/html;charset=utf-8," + quote(html))
# 页面主体是后续检查的前置条件,失败时立即终止。
summary = driver.find_element(By.ID, "summary")
assert summary.is_displayed()
soft.equal(
driver.find_element(By.ID, "status").text,
"已完成",
"状态",
)
soft.equal(
driver.find_element(By.ID, "total").text,
"$109.00",
"金额",
)
# 所有可继续检查完成后,只在这里统一让用例失败。
soft.assert_all()
finally:
driver.quit()预期结果
text
同一次 test_order_summary 执行会收集 2 条失败:状态不匹配、金额不匹配。保存为 test_soft_assert.py 后执行:
bash
python -m pytest -q test_soft_assert.py预期输出
text
F
AssertionError: 2 条软断言失败:
1. 状态: actual='处理中', expected='已完成'
2. 金额: actual='$99.00', expected='$109.00'
1 failed in <TIME>spytest 的堆栈前缀会随版本变化,实际耗时也会不同;验收点是一次测试结束时同时出现两条差异,而不是第一条失败后立即停止。
控制软断言的边界
不要把所有 assert 都改成软断言。真实项目里通常先做 1~2 个硬前置检查,例如 URL 已进入订单页、关键容器可见,再对容器内 3~10 个独立字段做软断言。若前置条件失败仍继续查找元素,报告里往往会堆出大量 NoSuchElementException,反而掩盖真正根因。
另一个边界是必须在用例结束前调用一次 assert_all()。如果只收集 failures 却不统一抛出,pytest 会把用例判为通过。最安全的做法是把收集器生命周期限定在单个测试函数内,不跨测试共享,避免上一条用例的失败污染下一条结果。
按自己的节奏,确认真正理解。