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

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

此文章来源于项目官方公众号:“AirtestProject”

版权声明:允许转载,但转载必须保留原链接;请勿用作商业或者非法用途

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

image.png

2)断言2个值相等/不相等
assert_equal(poco("score").get_text(), "100", "分数为100分")
assert_not_equal(poco("score").get_text(), "0", "分数不为0")

image.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报告,断言步骤的描述上:

image.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)

image.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新版的内容,欢迎同学们持续关注我们后续的推文。


AirtestIDE下载:airtest.netease.com/

Airtest 教程官网:airtest.doc.io.netease.com/

搭建企业私有云服务:airlab.163.com/b2b


相关文章
|
IDE 开发工具
Poco脚本的点击位置与点击偏移
Poco脚本的点击位置与点击偏移
315 0
|
11月前
|
缓存 5G 开发者
【提效】docker镜像构建优化-提速10倍
本文主要记录了自己通过查阅相关资料,一步步排查问题,最后通过优化Docerfile文件将docker镜像构建从十几分钟降低到1分钟左右,效率提高了10倍左右。
954 122
|
SQL 资源调度 Java
mybatis-plus代码生成器的UI界面使用非常方便
mybatis-plus代码生成器的UI界面使用非常方便
266 0
|
机器学习/深度学习 存储 安全
基于YOLOv8深度学习的钢材表面缺陷检测系统【python源码+Pyqt5界面+数据集+训练代码】目标检测、深度学习实战
基于YOLOv8深度学习的钢材表面缺陷检测系统【python源码+Pyqt5界面+数据集+训练代码】目标检测、深度学习实战
|
存储 SQL 算法
优化解码方法:记忆化搜索和空间优化动态规划的实用指南 【LeetCode 题目 91】
优化解码方法:记忆化搜索和空间优化动态规划的实用指南 【LeetCode 题目 91】
|
消息中间件 SQL 弹性计算
RocketMQ中使用Java客户端发送消息和消费的应用
本教程将总结使用java客户端消息发送和消费各种场景, 并Demo演示
|
数据挖掘 Linux
如何在 Linux 中将输出重定向到文件和标准输出?如此简单!
如何在 Linux 中将输出重定向到文件和标准输出?如此简单!
2728 0
如何在 Linux 中将输出重定向到文件和标准输出?如此简单!
|
机器学习/深度学习 人工智能 物联网
快速玩转 Llama2!机器学习 PAI 最佳实践(三)—快速部署WebUI
本实践将采用阿里云机器学习平台PAI-EAS 模块针对 Llama-2-13B-chat 进行部署。PAI-EAS是模型在线服务平台,支持将模型一键部署为在线推理服务或AI-Web应用,具备弹性扩缩的特点,适合需求高性价比模型服务的开发者。
1963 4
|
Java
Excel解析为java对象
Excel解析为java对象
187 0