- 1、Tests的介绍
- 2、常用SNIPPETS(片段)说明
- (1)常用变量相关
- (2)状态码相关
- (3)响应结果断言:
- (4)Header :
- (5)响应速度:
- 3、示例
- (1)响应码断言
- (2)返回值断言(非常频繁)
我们检验一个测试用例是否通过,一般会将我们心理预期的结果与实际结果进行比对,如果结果一致则证明测试通过,如果结果不一致,则证明测试不通过,这即是我们经常所说的断言。
1、Tests的介绍
返利网 www.cpa5.cnPostman中的断言是使用请求后脚本Tests
,是对状态码、响应头、响应正文等信息进行断言操作。
在Postman中封装了我们常见的断言代码片段,当然Tests
除了可以作为断言,还可以当做后置处理器。
经常应用于:
- 断言。
- 获取当前接口的响应数据,传递给下一个接口。
提示:在一个请求或者一个集合都可以定义
Tests
,在集合中定义Tests
,表示集合中的每一个请求响应后,都需要执行Tests
中的断言脚本。
点击请求中的Tests
标签项,如下图:
我们可以在上图看到,在Tests
标签页的右侧边栏中,Postman为我们提供了一些常用的代码模版。
提示我们:
Test scripts are written in JavaScript, and are run after the response is received.
测试脚本用JavaScript编写,并在收到响应后运行。
Learn more about tests scripts
点击这里,可以学习更多关于测试脚本的资料。
学习关于
Tests
的更多用法,请进入后面链接:https://go.pstmn.io/docs-test-scripts。
总结:
(1)Postman测试沙箱的执行顺序
- 在发送Request之前,执行
Pre-request Script
中的js脚本,可定制化Request(准备数据)。 - 收到Response之后,执行
Tests
中的脚本,处理返回的数据(断言或者处理数据)。
整个流大概是这样的:
(2)Postman中Tests
的作用
- 做断言:可以断言状态码或者断言返回数据中的字段。
- 取返回值:做流程接口的时候,向下传递返回数据。
2、常用SNIPPETS(片段)说明
(1)常用变量相关
Get an environment variable
:获取一个环境变量。Get a gloval variable
:获取一个全局变量。Get a variable
:获取一个变量(本地)。Set an environment variable
:设置一个环境变量。Set a global variable
:设置一个全局变量。Clear an environment variable
:清空一个环境变量。Clear a global variable
:清空一个全局变量 。
使用:
- 获取变量:如果在下一个请求中用到上一个请求的返回值,可以使用“设置一个环境变量”,将请求的返回值设置为环境变量,在下一个请求中,使用“获取一个环境变量”取到该值。
- 清空变量:这里的清空等于删除变量,一个参数使用完成后,需要删除,或者清空值都可以使用该方法。
(同前一篇Pre-request Script
的使用方式一样)
(2)状态码相关
Status code: Code is 200
:判断状态码是否正确;默认判断状态是否为 200, 可修改。pm.test("Status code is 200", function () { pm.response.to.have.status(200); });
Status code:Successful POST request
:
判断状态码是否为预期结果之一;比如默认断言状态码是否是 201, 202 中的一个。pm.test("Successful POST request", function () { pm.expect(pm.response.code).to.be.oneOf([201, 202]); });
Status code:Code name has string
判断状态码描述是否包含字符串,比如是否包含 Created。pm.test("Status code name has string", function () { pm.response.to.have.status("Created"); });
(3)响应结果断言:
Response body: Contains string
:
响应结果是否包含字符串;
注意:这只能检查Response body中raw格式展示的返回数据,如果raw格式展示的返回数据中,有中文数据未解码,也只能匹配未解码形式的内容,且匹配包含不唯一(工作中很少见,一般接口返回数据中不会设计重复字段)。pm.test("Body matches string", function () { // 比如raw中的数据,“学院”没有进行Unicode解码,就只能如下方式进行比对。 pm.expect(pm.response.text()).to.include("例如:学院"); });
Response body: JSON value check
:
响应结果如果是 JSON格式的数据,检查具体的 JSON字段的值;
实际工作中基本就用这个方式。(下面有练习好好看看)pm.test("Your test name", function () { var jsonData = pm.response.json(); pm.expect(jsonData.value).to.eql(100); });
Response body: Is equal to a string
:
响应结果与字符串是否全部匹配预期的字符串;
就是在把Response body的数据用raw格式展示,然后全部复制到下面位置。pm.test("Body is correct", function () { pm.response.to.have.body("raw格式展示的返回数据,全部复制到这里"); });
Response body: Convert XML body to a JSON Object
:
将 XML 转换成 JSON;var jsonObject = xml2Json(responseBody);
等等还有很多,用的时候我们可以查看相关文档。
(4)Header :
Response headers:Content-Type header check
响应头部中是否包含字段,代码片段如下:
pm.test("Content-Type is present", function () {
pm.response.to.have.header("Content-Type(这里填写请求头属性)");
});
(5)响应速度:
Response time is less than 200ms
响应时间是否少于多少 ms。
pm.test("Response time is less than 200ms", function () {
pm.expect(pm.response.responseTime).to.be.below(200);
});
3、示例
(1)响应码断言
我们以“添加学院测试为例”
1)准备数据
在Pre-request Script
编辑如下代码,来准备数据
// 随机生成一个3位数字的id
var dep_id = Math.floor(Math.random()*1000);
pm.environment.set("depid" , dep_id); //设置到环境变量中
// 随机生成学院名称dep_name
// 随机生成一个10位的字符串
var data = Math.random().toString(36).slice(-10) ;
var dep_name = data+"学院";
pm.environment.set("dep_name" , dep_name);//设置到环境变量中
// 随机生成院长的名字
var first_name = ["赵","钱","孙","李","刘"];
var last_name = ["子鼠","丑牛","寅虎","牟兔","辰龙","巳蛇"];
var master_name = first_name[Math.floor(Math.random() * (first_name.length))] +last_name[Math.floor(Math.random() * (last_name.length))];
pm.environment.set("master_name" , master_name);//设置到环境变量中
// 随机生成口号
var slogan_str = ["吃饭","睡觉","打豆豆"];
var slogan = slogan_str[Math.floor(Math.random() * (slogan_str.length))];
pm.environment.set("slogan" , slogan);//设置到环境变量中
// 很low的代码,只做练习
2)编辑请求所要提交的数据
3)编写Tests
中的断言
使用Tests
中的Status code: Code is 200
内置代码片段。
// 用来断言接口请求的状态码,针对HTTP协议状态码。
// pm.test 表示Postman进行测试断言
// "Status code is 200" 表示断言的名称或者说明,一般和测试用例同名
// function 表示 执行断言的方法
pm.test("新增学院请求正常放回201", function () {
pm.response.to.have.status(201);
});
4)查看断言结果
如下图:
提示:
Test Results(1/1)
:表示一共有1个断言,执行通过了1个断言。
All
:表示显示所有断言。
Passed
:表示只显示通过的断言。
Skipped
:表示只显示跳过的断言。
Failed
:表示只显示失败的断言。
当我们断言执行失败时,也会有详细提示,如把上面的状态码改成202。
AssertionError: expected response to have status code 202 but got 201
AssertionError:预期响应的状态码为202,但得到201。
(2)返回值断言(非常频繁)
返回值断言,就是对接口返回的数据(body主体)中的字段进行验证。
以返回值为json格式的数据为例:
这里先标识一下,接口的实际返回结果如下:
{
"create_success": {
"count": 1,
"results": [
{
"dep_id": "637",
"dep_name": "k7iwvtgk2h学院",
"master_name": "李子鼠",
"slogan": "睡觉"
}
]
},
"already_exist": {
"count": 0,
"results": []
}
}
同上面练习,直接编写Tests
中的断言,
使用Tests
中的Response body: JSON value check
内置代码片段。
// 断言返回值为json格式的数据
// pm.test 表示Postman进行测试断言
// "Your test name" 表示断言的名称或者说明,一般和测试用例同名
// function 表示 执行断言的方法
// jsonData 表示接口返回的所有数据
// pm.expect 表示设置断言的预期
// jsonData.value 表示取具体的某一字段,一级一级点下去就可以(层级关系)
pm.test("断言添加学院数量", function () {
var jsonData = pm.response.json(); // 获取返回值所有数据
pm.expect(jsonData.create_success.count).to.eql(1); // 断言返回值中具体字段的值
});
然后执行并查看结果:
说明:
如果结果返回的json数据中有数组,如下:我们要取slogan
字段
{
"create_success": {
"count": 1,
"results": [
{
"dep_id": "637",
"dep_name": "k7iwvtgk2h学院",
"master_name": "李子鼠",
"slogan": "睡觉"
}
]
},
"already_exist": {
"count": 0,
"results": []
}
}
需要如下方式进行选取:
pm.test("断言添加学院的口号", function () {
// 获取返回值所有数据,赋值给jsonData
var jsonData = pm.response.json();
// 可以使用console.log在控制台输出内容,进行调试
// console.log(jsonData.create_success.results[0].slogan)
// 断言返回值中具体字段的值
pm.expect(jsonData.create_success.results[0].slogan).to.eql("哈哈哈"); //这里是重点
});
其他代码片段使用方式同理,这里就不一一举例了。其实
Tests
中编写的就是JavaScript脚本,你也可以编写循环、判断、输出到控制台等代码。