原文链接
本文节选自霍格沃兹测试开发学社内部教材
断言是 UI 自动化测试的三要素之一，是 UI 自动化不可或缺的部分。在使用定位器定位到元素后，通过脚本进行业务操作的交互，想要验证交互过程中的正确性就需要用到断言。
常规的UI自动化断言
分析正确的输出结果，常规的断言一般包含以下的几个情形：
-
比较大小
-
包含或者不包含
-
验证布尔值
Python 示例代码
# 第一种 ：比较大小
price = driver.find_element(
By.XPATH,'//*[contains(@resource-id="current_price")]').text
assert float(price) >=170
# 第二种 ：包含验证
name = driver.find_element(
By.XPATH,'//*[contains(@resource-id="stockName")]').text
assert "BABA" in name
# 第三种 ：布尔值验证
def check():
name = driver.find_elements(By.XPATH,'//*[contains(@resource-id="stockName")]')
return True if len(name)!=0 else False
assert check()
上面的示例可以看出，Python 的 assert 是用来判断一个条件是否为真，如果它为真，就继续执行，如果为假，则抛出 AssertError 并且包含错误信息。断言可以在条件不满足程序运行的情况下直接返回错误。
Java 示例代码
// 第一种 ：比较大小
String price = driver.findElement(By.xpath("//*[contains(@resource-id=\"current_price\")]")).getText();
float currentprice = Float.parseFloat(price);
float expectprice = 170;
assert currentprice >= expectprice;
// 第二种 ：包含验证
String name = driver.findElement(By.xpath("//*[contains(@resource-id=\"stockName\")]")).getText();
assert name.contains("BABA");
// 第三种 ：布尔值验证
@Test
public boolean check(){
List<WebElement> names = driver.findElements(By.xpath("//*[contains(@resource-id=\"stockName\")]"));
return names.size() > 0 ? true : false;
}
@Test
public void checkTest(){
assert check();
}
上面的示例可以看出，测试中经常会需要使用断言来判断一个条件是否为真，Java 语法中也可以通过 assert 关键字进行断言。另外如果需要更复杂的断言处理，可以使用 Hamcrest 提供的方法，Hamcrest 提供了大量被称为“匹配器”的方法。
Hamcrest断言
Hamcrest 是一个以测试为目的，能组合成灵活表达式的匹配器类库，用于编写断言的框架，使用这个框架编写断言，可以提高可读性以及开发测试的效率。Hamcrest 提供了大量被称为“匹配器”的方法。每个匹配器都设计用于执行特定的比较操作。Hamcrest 的可扩展性强，允许创建自定义的匹配器，并支持多种语言。
Hamcrest 安装
- Python 版本
pip install pyhamcrest
- Java 版本
<dependency>
<groupId>org.hamcrest</groupId>
<artifactId>hamcrest</artifactId>
<version>2.2</version>
<scope>test</scope>
</dependency>
Hamcrest 导包
- Python 版本
from hamcrest import *
- Java 版
import static org.hamcrest.MatcherAssert.assertThat;
import static org.hamcrest.Matchers.*;
Hamcrest 提供了一个全新的断言语法（assert_that），可以只使用 assert_that 一个断言语句，结合 Hamcrest 提供的匹配符，就可以完成各种断言场景。
常用方法 API
1.比较两个字符串相等，示例代码如下：
- Python 版本
assert_that("this is a string",equal_to("this is a string"))
- Java 版本
assertThat("this is a string",equalTo("this is a string"));
2.数值匹配，比较两个值是否接近，示例代码如下：
- Python 版本
assert_that(8,close_to(10,2))
- Java 版本
assertThat(8.0,closeTo(10,2));
解释：断言 8 接近于 （8 ~ 12）这个范围。
3.包含某个字符，示例代码如下：
- Python 版本
assert_that('abc',contains_string('d'))
- Java 版本
assertThat("abc",containsString("d"));
案例
使用“雪球”应用，打开雪球 APP，点击页面上的搜索输入框输入“alibaba”，然后在搜索联想出来的列表里面点击“阿里巴巴”，选择股票分类，获取股票类型为“09988”的股票价格，最后验证价格在预期价格的 10% 范围浮动。核心代码如下：
PYTHON 版本
from hamcrest import assert_that, close_to
...
def test_wait(self):
# 点击搜索输入框
self.driver.find_element_by_id(
"com.xueqiu.android:id/tv_search").click()
# 输入 “alibaba”
self.driver.find_element_by_id(
"com.xueqiu.android:id/search_input_text"
).send_keys("alibaba")
# 点击“阿里巴巴”
self.driver.find_element_by_xpath("//*[@text='阿里巴巴']").click()
# 点击“股票”
self.driver.find_element_by_xpath(
"//*[contains(@resource-id,'title_container')]//*[@text='股票']"
).click()
# 获取股票价格
locator = (MobileBy.XPATH,
"//*[@text='09988']/../../..\
//*[@resource-id='com.xueqiu.android:id/current_price'")
ele = WebDriverWait(self.driver,10)\
.until(expected_conditions.element_to_be_clickable(locator))
print(ele.text)
current_price = float(ele.text)
expect_price = 170
# 使用 hamcrest 断言来判断股票价格浮动在 10% 范围内
assert_that(current_price,
close_to(expect_price, expect_price*0.1))
...
JAVA 版本
import static org.hamcrest.MatcherAssert.assertThat;
import static org.hamcrest.Matchers.*;
...
@Test
public void wait1Test(){
// 点击搜索输入框
driver.findElementById("com.xueqiu.android:id/tv_search").click();
// 输入 “alibaba”
driver.findElementById("com.xueqiu.android:id/search_input_text").sendKeys("alibaba");
// 点击“阿里巴巴”
driver.findElementByXPath("//*[@text=\"阿里巴巴\"]").click();
// 点击“股票”
driver.findElementByXPath("//*[contains(@resource-id,\"title_container\")]//*[@text=\"股票\"]").click();
// 获取股票价格
By price_locator = By.xpath("//*[@text='09988']/../../..//*[@resource-id=\"com.xueqiu.android:id/current_price\"]");
WebDriverWait wait = new WebDriverWait(driver, 10);
WebElement ele = wait.until(ExpectedConditions.elementToBeClickable(price_locator));
System.out.println(ele.getText());
double currentPrice = Double.parseDouble(ele.getText());
double expectPrice = 170;
// 使用 hamcrest 断言来判断股票价格浮动在 10% 范围内
assertThat(currentPrice, closeTo(expectPrice,expectPrice*0.1));
}
...
上面的示例中，通过assert_that/assertThat 是用于生成测试断言的样式化语句，比较两个值（current_price 与 expect_price）是否接近，断定实际值 current_price 在expect_price-expect_price0.1 与 expect_price+expect_price0.1 范围区间浮动。