自动化测试 / 系统课时

组织软断言

组织软断言

软断言适合一个页面上有多项彼此独立的验证:某一项失败时先记录问题,继续检查其余项目,最后一次性让用例失败。这样一次运行就能看到完整差异,同时仍把“页面是否能继续操作”这类前置条件保留为硬断言。

学习目标

  • 区分硬断言与软断言,知道哪些失败可以继续收集。
  • 在 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>s

pytest 的堆栈前缀会随版本变化,实际耗时也会不同;验收点是一次测试结束时同时出现两条差异,而不是第一条失败后立即停止。

控制软断言的边界

不要把所有 assert 都改成软断言。真实项目里通常先做 1~2 个硬前置检查,例如 URL 已进入订单页、关键容器可见,再对容器内 3~10 个独立字段做软断言。若前置条件失败仍继续查找元素,报告里往往会堆出大量 NoSuchElementException,反而掩盖真正根因。

另一个边界是必须在用例结束前调用一次 assert_all()。如果只收集 failures 却不统一抛出,pytest 会把用例判为通过。最安全的做法是把收集器生命周期限定在单个测试函数内,不跨测试共享,避免上一条用例的失败污染下一条结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

组织软断言

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

登录哪都通