自动化测试 / 系统课时
编写结果断言
编写结果断言
Selenium 用例只有在验证可观察结果后才真正完成。页面能点击并不等于业务成功,本篇用一条完整测试同时检查文本、元素状态、URL 和订单状态,并区分“等待页面进入稳定状态”与“断言结果是否正确”这两个职责。
学习目标
- 使用
unittest断言验证文本、元素状态、URL 和业务状态。 - 在异步页面中先等待稳定条件,再执行结果断言。
- 避免只验证“元素存在”或“按钮可点击”这类弱断言。
把等待条件与业务断言分开
显式等待解决的是时序问题,断言解决的是正确性问题。例如支付后最多等待 5 秒,直到状态文本出现“支付成功”;等待满足后,再断言按钮已禁用、URL 已进入回执位置,并检查订单状态为 PAID。不要用 time.sleep(5) 同时承担这两个职责。
推荐把等待时间先固定为一个明确预算,例如普通本地或测试环境使用 5 秒。若元素 0.4 秒就满足条件,WebDriverWait 会立即继续;若 5 秒仍未满足,则应以超时失败暴露同步或业务问题,而不是继续扩大固定休眠时间。
一次覆盖四类结果
下面示例适用于 Selenium Python 4.x。测试页面完全在临时文件中运行,点击“支付”后同步修改四个可观察结果,再由 Selenium 等待文本条件并逐项断言,因此可以直接运行验证断言写法。
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> 为实际运行耗时:
.
----------------------------------------------------------------------
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;保存测试可验证成功提示及保存后的数据;下单测试则应验证订单状态。页面定位、点击成功和等待结束都是过程信号,不能替代最终结果断言。