自动化测试 / 系统课时

编写结果断言

编写结果断言

Selenium 用例只有在验证可观察结果后才真正完成。页面能点击并不等于业务成功,本篇用一条完整测试同时检查文本、元素状态、URL 和订单状态,并区分“等待页面进入稳定状态”与“断言结果是否正确”这两个职责。

学习目标

  • 使用 unittest 断言验证文本、元素状态、URL 和业务状态。
  • 在异步页面中先等待稳定条件,再执行结果断言。
  • 避免只验证“元素存在”或“按钮可点击”这类弱断言。

把等待条件与业务断言分开

显式等待解决的是时序问题,断言解决的是正确性问题。例如支付后最多等待 5 秒,直到状态文本出现“支付成功”;等待满足后,再断言按钮已禁用、URL 已进入回执位置,并检查订单状态为 PAID。不要用 time.sleep(5) 同时承担这两个职责。

推荐把等待时间先固定为一个明确预算,例如普通本地或测试环境使用 5 秒。若元素 0.4 秒就满足条件,WebDriverWait 会立即继续;若 5 秒仍未满足,则应以超时失败暴露同步或业务问题,而不是继续扩大固定休眠时间。

一次覆盖四类结果

下面示例适用于 Selenium Python 4.x。测试页面完全在临时文件中运行,点击“支付”后同步修改四个可观察结果,再由 Selenium 等待文本条件并逐项断言,因此可以直接运行验证断言写法。

python
from pathlib import Path
from tempfile import TemporaryDirectory
import unittest

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait


class ResultAssertionTest(unittest.TestCase):
    def setUp(self):
        self.temp_dir = TemporaryDirectory()
        self.addCleanup(self.temp_dir.cleanup)

        page = Path(self.temp_dir.name) / "checkout.html"
        page.write_text(
            """<!doctype html>
<html lang="zh-CN">
<body>
  <button id="pay">支付</button>
  <p id="message">等待支付</p>
  <p id="order-state" data-state="PENDING">PENDING</p>
  <script>
    document.querySelector('#pay').addEventListener('click', (event) => {
      event.currentTarget.disabled = true;
      document.querySelector('#message').textContent = '支付成功';
      const state = document.querySelector('#order-state');
      state.dataset.state = 'PAID';
      state.textContent = 'PAID';
      location.hash = 'receipt';
    });
  </script>
</body>
</html>""",
            encoding="utf-8",
        )

        self.driver = webdriver.Chrome()
        self.addCleanup(self.driver.quit)
        self.driver.get(page.resolve().as_uri())

    def test_payment_result(self):
        pay_button = self.driver.find_element(By.ID, "pay")
        pay_button.click()

        # 等待只负责确认页面已经进入可断言的稳定状态。
        WebDriverWait(self.driver, 5).until(
            EC.text_to_be_present_in_element((By.ID, "message"), "支付成功")
        )

        message = self.driver.find_element(By.ID, "message")
        order_state = self.driver.find_element(By.ID, "order-state")

        self.assertEqual(message.text, "支付成功", "支付结果文本不正确")
        self.assertFalse(pay_button.is_enabled(), "支付完成后按钮仍可点击")
        self.assertTrue(
            self.driver.current_url.endswith("#receipt"),
            "支付完成后没有进入回执 URL",
        )
        self.assertEqual(
            order_state.get_attribute("data-state"),
            "PAID",
            "订单业务状态不是 PAID",
        )


if __name__ == "__main__":
    unittest.main()

预期输出,<TIME> 为实际运行耗时:

text
.
----------------------------------------------------------------------
Ran 1 test in <TIME>s

OK

把任一预期值故意改错,例如把 "PAID" 改为 "CANCELLED",测试应进入失败状态而不是继续显示 OK。这种负向检查可以确认断言确实覆盖了目标结果,而不是因为定位器错误或条件永远为真而产生假通过。

为不同结果选择合适断言

断言应直接对应业务事实,而不是间接猜测。文本值适合 assertEqual,开关状态适合 assertTrue 或 assertFalse,URL 若只有路径或锚点重要,就只验证稳定部分;业务状态则应检查明确的状态值,而不是只确认某个容器存在。

要验证的结果 可直接使用的检查 示例期望值
页面文本 assertEqual(element.text, expected) 支付成功
元素可用状态 assertFalse(element.is_enabled()) 支付按钮不可再次点击
URL 稳定部分 assertTrue(current_url.endswith(...)) #receipt
业务状态 assertEqual(get_attribute(...), expected) PAID

错误做法是支付后只写 assertTrue(driver.find_element(By.ID, "message"))。只要元素存在,这个断言就会通过,即使文本仍是“等待支付”。正确做法应断言真正会因业务成功而变化的值。

避免脆弱和过度宽松的断言

不要把页面全部文字、完整动态 URL 或整段 HTML 当成单一断言对象。若 URL 可能附带 ?trace=<ID>,测试真正关心的是回执页面时,就验证稳定的路径或锚点;若按钮禁用是防止重复提交的业务要求,则应明确检查 is_enabled(),而不是依赖按钮颜色变化。

一个结果至少要回答“用户或系统最终得到了什么”。登录测试可验证用户菜单出现和受保护 URL;保存测试可验证成功提示及保存后的数据;下单测试则应验证订单状态。页面定位、点击成功和等待结束都是过程信号,不能替代最终结果断言。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写结果断言

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

登录哪都通