什么是断言?在接口测试中,我们预设接口响应结果中会出现一个片段,我们称之为预期值,断言会在接口调用后尝试捕捉这个预期值,如果能捕捉到,则判定接口成功,否则判定接口为失败。用过loadrunner的朋友一定记得检查点这个概念,断言和检查点实质上是一样的。
为什么需要断言?因为JMeter默认接口响应码200即为成功:
其实,接口的业务并非成功。
为了甄别接口是否实现业务上的成功,我们便需要引入断言。
在取样器上右键–添加–断言,可以看到,JMeter提供了丰富的断言实现(JMeter版本:5.1.1,下同)
创建方式:在线程组或者HTTP请求上右键–>添加–>断言–>响应断言,就创建了一个断言:
关于断言的作用域:在线程组上创建断言,则该断言对线程组下所有取样器生效,而在取样器上创建,则只对该取样器生效。
一般情况下,我们用默认配置即可。各个项目也简略解释一下。
Apply to:即应用范围,一般使用Main sample only模式。Main sample代表主请求,Sub-samples代表主请求下的子请求。
测试字段(Field to test):表示在何种内容中匹配预期字段,一般选择响应文本。
响应文本:接口的Response的全部数据
响应代码:取样器结果中的Response code,常见的有200(成功)、302(重定向)、404(不存在)、400(参数错误)、500(服务器错误)等。但当我们要验证404,501等http响应代码时,需要勾选 ignore status,因为当http响应代码为404、500时,JMeter会默认这个请求是失败的。
响应信息:取样器结果中的Response message
响应头:响应数据的Response headers
请求头:请求的Request headers
URL样本:有跟随重定向时,URL样本包含了请求的URL和重定向的URL,否则只包含请求URL。
模式匹配规则(Pattern Matching Rules):即响应数据与预期值的对比方式。
包括(Contains):响应数据包含预期值(相当于String的contains方法),则判定接口成功。支持正则匹配。
匹配(Matches): 用正则表达式匹配返回结果,且必须能匹配整个返回值,而不是返回值的一部分。
相等(Equals):响应数据与预期值完全相同才判定接口成功。不支持正则表达式。
字符串(Substring):与【包括】类似,但不支持正则匹配。
否(Not):取反,也就是前面【包括】等判定结果为true,断言结果为false。反之,前面判定为false,断言结果为true。
或者(Or):勾选此项后,可以设置多个预期值,只要有一项判定成功,则断言判定成功。
测试模式(Patterns to test):预期值表达式,可以是正则表达式,也可以是字符串。可以通过【添加】按钮添加一个或多个,有多个的话,不勾选【模式匹配规则】中的【或者】,则为并集模式,即全部匹配成功才断言成功。
自定义失败消息(Custom failure message):当判断返回值为错误的时候,自定义的失败消息会在断言结果中显示。
下面用看一个小例子。请求百度:
响应数据:
在【百度一下】请求下添加响应断言:
执行请求,查看结果树:
结果被标红,接口判定为失败。可见,你预设的断言决定了接口是否被判定成功。把上面断言中的“百度两下”改为“百度一下”,再次执行,则接口判定为成功。
JSON断言针对响应结果是applicaton/json格式的请求进行断言。
在取样器下右键–>添加–>断言–>JSON断言,就创建了一个JSON断言,界面如下:
Assert JSON PATH exists:针对响应结果中特定字段进行提取的路径表达式。
Additionally assert value:附加断言值,勾选此项后才能填写Expected value。
Match as regular expression:作为正则表达式匹配。
Expected value:预期值,这个值将与Assert JSON PATH exists提取到的值对比,一致则判定接口成功。
下面照例进行一个实例演示。首先,创建一个Beanshell取样器模拟接口,返回JSON数据。
return "{\"code\":0,\"message\":\"操作成功\",\"data\":{\"student\":[{\"name\":\"zhangxu\",\"age\":18},{\"name\":\"zhoushuang\",\"age\":18},{\"name\":\"changhua\",\"age\":17}]}}";
在该取样器下添加JSON断言,照下图写入:
这里解释一下【JSON Path expression】的写法,首先$.这部分是固定写法,后面根据层级关系去逐级获取数据。 1、$.data表示在JSON串以"data"为key获取value,也就是{“student”:[{“name”:“zhangxu”,“age”:18},{“name”:“zhoushuang”,“age”:18},{“name”:“changhua”,“age”:17}]}。 2、$.data.student对应的是[{“name”:“zhangxu”,“age”:18},{“name”:“zhoushuang”,“age”:18},{“name”:“changhua”,“age”:17}],因此要通过索引定位到数组中的具体对象,也就是$.data.student[0]获取到了{“name”:“zhangxu”,“age”:18} 3、$.data.student[0].name就定位到了“zhangxu”这个值。
运行脚本,察看结果树显示接口成功。
如果我们把Expected value改为"zhangxu2",再次运行,发现接口被判定失败:
这种断言是应对复杂校验的利器,为什么这么说呢?因为Bean Shell断言可以写较复杂的逻辑判断来对结果进行校验。
还以2.2中的模拟接口为例,创建一个Beanshell断言:
运行脚本,察看结果树:
当然,这只是一个简单的示例,更丰富的用法请见:JMeter Bean Shell Sampler与JMeter Bean Shell断言。
大小断言:判断响应结果选定部分的字节大小是否与预期的值相符。
断言持续时间:判断接口的响应时间是否小于等于设定值。
作者:云深i不知处
原文链接:https://blog.csdn.net/mu_wind/article/details/108204489#comments_15058574