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

Posted 2023-04-07 爱吃 香菜

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)), “请填写测试点”)

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

assert_equal(poco(“score”).get_text(), “100”, “分数为100分”)

assert_not_equal(poco(“score”).get_text(), “0”, “分数不为0”)

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报告，断言步骤的描述上：

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)

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%免费】

Airtest自动化测试篇——Airtest简介

目录

1. 自动化测试的分层

2. UI自动化工具的比较

3. UI自动化面临的问题

4. Airtest的简介

5. 自动化测试的分层

一般将自动化测试从上往下分为三层：

1. UI自动化测试

2. 接口自动化测试

3. 单元/模块自动化测试
   

1.1 单元/模块自动化

单元/模块自动化是直接对代码逻辑进行自动化测试，大多数由开发实施，少部分公司会由白盒测试公司实施。

常用的工具有Java的Junit、testNG，Python的unittest，pytest等。

1.2 集成接口自动化

接口层的自动化测试主要是对系统和组件之间的接口进行测试，主要目标是校验数据的交换和业务的流程，接口测试可以测试功能、也可以测试性能、测试压力、测试安全等等。

由于接口比代码单元要稳定的很多，所以自动化脚本维护成本更低、收益也更大，具有不错的性价比。

常用的测试工具有：Jmeter、Loadrunner、Postman、SoupUI等

1.3 UI自动化

UI自动化是目前做的最多的自动化，是自动化测试中最接近用户侧的测试，尝试将黑盒的功能和UI测试用程序或功能来执行。

UI层的自动化工具一般按照平台来分：有windows、Linux、Android、IOS、Web、微信小程序等。

2. UI自动化工具的比较

目前常用的UI自动化的工具大致可以按照平台的不同分为：

1. 桌面自动化工具

2. web端自动化工具

3. App自动化工具

2.1 桌面端自动化工具

2.1.1 AutoIt3

基于VB实现，获取信息少，编程实现复杂

https://www.autoitscript.com/site/autoit/downloads/

2.1.2 Microsoft UI Automation

Microsoft UI Automation是一个可访问性框架，它使Windows应用程序能够提供和使用有关用户界面（UI）的编程信息。

它提供对桌面上大多数UI元素的编程访问。它使辅助技术产品（如屏幕阅读器）能够向最终用户提供有关UI的信息，并通过标准输入以外的方式操作UI。UI Automation还允许自动化测试脚本与UI交互

https://github.com/microsoft/Microsoft-UI-UIAutomation

2.1.3 pywin32

pywin32是一个Python库，它为Python提供访问Windows API的扩展，提供了齐全的windows常量、接口、线程以及COM机制等等，安装后会自带一个pythonwin的IDE

https://github.com/mhammond/pywin32

2.2 Web端自动化工具

2.2.1 selenium

目前最主流的web自动化工具，几乎完美支持所有主流浏览器和主流编程语言，轻量并开源

https://github.com/SeleniumHQ/selenium

2.2.2 QTP/UFT

老牌的商业自动化工具，使用VB script，支持脚本的录制和回放

https://www.microfocus.com/zh-cn/products/uft-one/overview

2.3 App自动化工具

目前最主流的是Appium，支持android和ios自动化，开源，支持多种开发语言。

下面是一个简单的App自动化工具对比：

3. UI自动化面临的问题

4. 移动端、桌面端和web端的开发平台和开发工具不同，很难使用一套工具对以上三端进行自动化测试

5. 随着需求和代码的更改，UI自动化的脚本代码需要随之更改，维护成本高，尤其在游戏测试领域，可能不到一周就要重写用例代码

6. 某些软件产品中的图片信息或者图片内容很难进行验证

7. 在游戏测试领域，游戏引擎种类多，UI实现方式也很多，所以以前游戏的自动化测试主要靠开发编写专用的测试工具，自动化比较难实现

8. Airtest的简介

4.1 简介

Airtest是一个由网易开发的跨平台的UI自动化测试框架，基于图像识别原理，适用于游戏和App。

源码地址：

https://github.com/AirtestProject/Airtest

项目文档：

https://airtest.readthedocs.io/zh_CN/latest/

优点：

基于python，跨平台，可以对桌面、web和移动端进行UI自动化测试，尤其适用于游戏和App，同时支持windows、android和ios

4.2 组成

整个工具套件由4个大的部分组成：

1. Airtest IDE

2. Airtest

3. Poco

4. Airlab

4.2.1 AirtestIDE

跨平台的UI自动化测试编辑器， 集成了python3.6，相关的airtest和poco库，无须本地安装python环境就能直接使用的集成开发环境，适合新手。

4.2.2 Airtest

Airtest是一款基于 Python 的、跨平台的UI自动化测试框架。基于图像识别的原理，适用于所有 Android、 iOS和 Windows 应用。因此，不论是手机上的app还是游戏，或者是Windows电脑上面的应用或者游戏等等，都可以用Airtest框架

4.2.3 Poco

Poco是一款基于 UI控件搜索 的自动化框架，它本质上也是 python 第三方库

4.2.4 Airlab

网易Airtest云测试服务