趁热打铁，一起来看下Airtest1.2.7新增的那些断言API

亦凉 2023-09-24 12:46 18阅读 0赞

### 1. 前言 ###

先前我们放出了1.2.7版本的Airtest，其中，一个很重要的功能是，我们 新增了非常丰富的断言API ，今天我们就来详细看一下新版Airtest都有给我们提供哪些断言语句。

### 2. 旧版Airtest提供的断言语句 ###

先回顾下，旧版Airtest一直以来，都只给我们提供了2种断言语句，一种是断言目标存在/不存在当前页面：

assert\_exists

assert\_not\_exists

另一种是断言2个值相等/不相等：

assert\_equal

assert\_not\_equal

**1）断言目标存在/不存在当前画面**

assert\_exists(Template(r"tpl1665570124249.png", record\_pos=(0.118, -0.026), resolution=(720, 1440)), “请填写测试点”)

assert\_not\_exists(Template(r"tpl1665570165989.png", record\_pos=(0.118, -0.032), resolution=(720, 1440)), “请填写测试点”)

![图片][ba611ab6d5134579b84c98cbb744364e.png]

**2）断言2个值相等/不相等**

assert\_equal(poco(“score”).get\_text(), “100”, “分数为100分”)

assert\_not\_equal(poco(“score”).get\_text(), “0”, “分数不为0”)

![图片][7eb62bd631fc4563a3c754622382be68.png]

**3. 新版Airtest新增的断言语句**

而Airtest1.2.7版本，又给我们新增了14个断言的API，包含断言表达式为True或者False（bool）、断言表达式为空/不为空、断言2个值的大小情况等：

1）断言表达式为True/False（bool）

from airtest.core.assertions import *
    
    # 断言表达式为True
    assert_true(1==1, msg="assert 1==1")
    
    # 断言表达式为False
    assert_false(1==2, msg="assert 1!=2")

2）断言2个对象相同/不相同

from airtest.core.assertions import *
    
    # 断言2个对象相同
    assert_is(1, 1, msg="assert 1 is 1")
    
    # 断言2个对象不相同
    assert_is_not(1, 2, msg="assert 1 is not 2")

3）断言表达式为None/不为None

from airtest.core.assertions import *
    
    # 断言表达式为None
    assert_is_none(None, msg="assert None is None")
    
    # 断言表达式不为None
    assert_is_not_none(1, msg="assert 1 is not None")

4）断言第一个参数是否在第二个参数中（包含关系）

from airtest.core.assertions import *
    
    # 断言第一个参数在第二个参数中
    assert_in(1, [1, 2], msg="assert 1 in [1, 2]")
    
    # 断言第一个参数不在第二个参数中
    assert_not_in(3, [1, 2], msg="assert 3 not in [1, 2]")

5）断言对象是不是某种类型的实例

from airtest.core.assertions import *
    
    # 断言对象是某种类型的实例
    assert_is_instance(1, int, msg="assert 1 is int")
    
    # 断言对象不是某种类型的实例
    assert_not_is_instance(1, str, msg="assert 1 is not str")
    
    这个断言语句中，第一个参数为obj，是一个具体的对象实例，第二个参数为cls，是一种类型，我们可以用这个断言来判断某个实例是不是属于某种类型的。
    
    不过这个断言，在AirtestIDE中执行会报一个错误，我们会在下个版本修复这个问题：
    
    TypeError: can't pickle mappingproxy objects

6）断言第一个值大于/大于等于第二个值

from airtest.core.assertions import *
    
    # 断言第一个值大于第二个值
    assert_greater(2, 1, msg="assert 2 > 1")
    
    # 断言第一个值大于等于第二个值
    assert_greater_equal(1, 1, msg="assert 1 >= 1")

7）断言第一个值小于/小于等于第二个值

from airtest.core.assertions import *
    
    # 断言第一个值小于第二个值
    assert_less(1, 2, msg="assert 1 < 2")
    
    # 断言第一个值小于等于第二个值
    assert_less_equal(1, 1, msg="assert 1 <= 1")

**4. 拓展：Airtest断言的msg参数说明**

可以看到，所有Airtest的断言语句中，都包含msg参数，这个参数是为了方便我们给当前的断言语句增加一个说明，并且该说明会显示在Airtest报告，断言步骤的描述上：

![图片][25f56c0ca4544ff18941df031f8e5c94.png]

**5. 拓展：Airtest断言的snapshot参数说明**

从Airtest1.2.7版本起，断言还新增了一个snapshot的参数，为了支持同学们在设置断言时，还能附带截取当前画面的图片，然后显示在Airtest报告中。

当然如果我们不需要断言截图的话，也可以设置关闭断言的截图：

# 默认情况下，断言截图会开启
    assert_is_not_none("1", msg="assert '1' is not None")
    
    # 如不需要断言时截取当前画面，则可以设置关闭断言的截图
    assert_is_not_none("1", msg="assert '1' is not None",snapshot=False)

![图片][22012bb316a14279a9a84027f7d85d45.png]

![图片][0f30fee60de449fb823ca999ed23fb11.png]

**1）assert\_exists关闭截图的特殊说明**

比较特别的是，assert\_exists 默认也是带截图的，但是要设置这个步骤不截图，不能使用 snapshot=False 来设置，而是要通过Airtest的全局设置来控制：

ST.SAVE_IMAGE = False
    
    assert_exists(Template(r"tpl1665719197992.png", "请填写测试点"))

assert\_not\_exists 也是同理。如果给assert\_exists强行传入snapshot=False，则会报错：

TypeError: assert_exists() got an unexpected keyword argument 'snapshot'

### 6. 小结 ###

今天我们主要介绍了旧版Airtest的断言，以及1.2.7版本Airtest新增的断言类型，还拓展了Airtest断言的相关参数说明。更多关于Airtest新版的内容，欢迎同学们持续关注我们后续的推文。

--------------------

### 资源分享 ###

**下方这份完整的软件测试视频学习教程已经上传CSDN官方认证的二维码，朋友们如果需要可以自行免费领取 `【保证100%免费】`**

![在这里插入图片描述][b9a9eea1ed5c42429c5e383b00ba6e0c.png_pic_center]

![在这里插入图片描述][d96b58a511f84668b59f3f620964da07.png_pic_center]

[ba611ab6d5134579b84c98cbb744364e.png]: https://img-blog.csdnimg.cn/ba611ab6d5134579b84c98cbb744364e.png
[7eb62bd631fc4563a3c754622382be68.png]: https://img-blog.csdnimg.cn/7eb62bd631fc4563a3c754622382be68.png
[25f56c0ca4544ff18941df031f8e5c94.png]: https://img-blog.csdnimg.cn/25f56c0ca4544ff18941df031f8e5c94.png
[22012bb316a14279a9a84027f7d85d45.png]: https://img-blog.csdnimg.cn/22012bb316a14279a9a84027f7d85d45.png
[0f30fee60de449fb823ca999ed23fb11.png]: https://img-blog.csdnimg.cn/0f30fee60de449fb823ca999ed23fb11.png
[b9a9eea1ed5c42429c5e383b00ba6e0c.png_pic_center]: https://img-blog.csdnimg.cn/b9a9eea1ed5c42429c5e383b00ba6e0c.png#pic_center
[d96b58a511f84668b59f3f620964da07.png_pic_center]: https://img-blog.csdnimg.cn/d96b58a511f84668b59f3f620964da07.png#pic_center