断言是 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 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 安装
pip install pyhamcrest
org.hamcrest
hamcrest
2.2
test
Hamcrest 导包
from hamcrest import *
import static org.hamcrest.MatcherAssert.assertThat;
import static org.hamcrest.Matchers.*;
Hamcrest 提供了一个全新的断言语法(assert_that),可以只使用 assert_that 一个断言语句,结合 Hamcrest 提供的匹配符,就可以完成各种断言场景。
常用方法 API
1.比较两个字符串相等,示例代码如下:
assert_that("this is a string",equal_to("this is a string"))
assertThat("this is a string",equalTo("this is a string"));
2.数值匹配,比较两个值是否接近,示例代码如下:
assert_that(8,close_to(10,2))
assertThat(8.0,closeTo(10,2));
解释:断言 8 接近于 (8 ~ 12)这个范围。
3.包含某个字符,示例代码如下:
assert_that('abc',contains_string('d'))
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 范围区间浮动。