postman—断言
Postman沙盒
Postman Sandbox是一个JavaScript执行环境,您可以在编写预请求脚本和测试脚本(在Postman和Newman中)时可用。在这个沙箱中执行您在预请求/测试脚本部分中写入的代码。可调用库。
postman沙盒详细介绍地址:https://learning.getpostman.com/docs/postman/scripts/postman_sandbox_api_reference/
Postman常用的断言:
在使用postman做接口测试的时候,可以在tests中对该接口进行断言设置
下面是几种常用的断言方式:
1.检验请求是否发送成功,也就是postman中的status是否为200
接口:http://suggest.taobao.com/sug?code=utf-8&q=女装&callback=cb(网上找的免费接口)
断言方式两种写法:第一种:tests[‘Status code is 200‘]=responseCode.code===200;第二种:
pm.test("Status code is 200", function () {
pm.response.to.have.status(200);
});其中“Status code is 200”可以任意编辑
2.断言响应数据的status是不是200:
接口:http://www.kuaidi100.com/query?type=yuantong&postid=11111111111
断言代码:
var jsondata=JSON.parse(responseBody)#获取响应的body部分并且转化成json格式 tests[‘断言响应数据里的status是否为200‘]=jsondata.status===‘200‘;
3.断言响应返回的数据中是否存在某个字段:
断言代码:
pm.test(‘是否存在字段com‘,function(){ pm.expect(pm.response.text()).to.include(‘com‘); });
4.断言响应数据里面的值是否正确:
附一段响应数据:
{ "status": 1, "message": "success", "data": [ { "id": 1, "title": "乡愁", "author": "余光中", "content": "小时候,乡愁是一枚小小的邮票,我在这头,母亲在那头。长大后,乡愁是一张窄窄的船票,我在这头,新娘在那头" }, { "id": 5, "title": "乡愁", "author": "余光中", "content": "小时候,乡愁是一枚小小的邮票,我在这头,母亲在那头。长大后,乡愁是一张窄窄的船票,我在这头,新娘在那头" } ] }
断言id是否等于1:
断言代码:
var jsonData = JSON.parse(responseBody); tests["Check respose status value"] = jsonData.status === 1; pm.test("判断data里面第一个json数据的id为1", function () { var jsonData = pm.response.json(); pm.expect(jsonData.data[0].id).to.eql(1);});
5.校验响应时间:
断言代码:
pm.test(‘响应时间是否小于300ms‘,function(){ pm.expect(pm.response.responseTime).to.be.below(300); });
6.校验响应数据中,返回的数据类型:
断言代码:
var jsondata=JSON.parse(responseBody); tests[‘判断com字段的值是不是string类型‘]=typeof(jsondata.com)===‘string‘;
7.断言响应数据中是否含有某个元素:
判断是否含有message这个元素
断言代码:
tests[‘判断是否含有message这个元素‘]=responseBody.has(‘message‘);
8.校验响应数据中的status是不是200或者301:
意思是:status为200或者301都算通过
断言代码:
pm.test("响应status code 是200,301就算成功", function () { pm.expect(pm.response.code).to.be.oneOf([200,301]); });
postman常见断言方法介绍:
Setting an environment variable (设置一个环境变量)
pm.environment.set(
"variable_key"
,
"variable_value"
);
Setting a nested object as an environment variable (将嵌套对象设置为环境变量)
var array = [1, 2, 3, 4]; pm.environment.set("array", JSON.stringify(array, null, 2)); var obj = { a: [1, 2, 3, 4], b: { c: ‘val‘ } }; pm.environment.set("obj", JSON.stringify(obj));
Getting an environment variable (获取环境变量)
pm.environment.get("variable_key");
Getting an environment variable (whose value is a stringified object) 获取一个环境变量(其值是一个字符串化的对象)
// These statements should be wrapped in a try-catch block if the data is coming from an unknown source. var array = JSON.parse(pm.environment.get("array")); var obj = JSON.parse(pm.environment.get("obj"));
Clear an environment variable (清除一个环境变量)
pm.environment.unset("variable_key");
Set a global variable (设置一个全局变量)
pm.globals.set("variable_key", "variable_value");
Get a global variable (获取一个全局变量)
pm.globals.get("variable_key");
Clear a global variable (清除全局变量)
pm.globals.unset("variable_key");
Get a variable (获取一个变量)
该函数在全局变量和活动环境中搜索变量。
pm.variables.get(
"variable_key"
);
Check if response body contains a string (检查响应主体是否包含字符串)
pm.test("Body matches string", function () { pm.expect(pm.response.text()).to.include("string_you_want_to_search"); });
Check if response body is equal to a string (检查响应主体是否等于一个字符串)
pm.test("Body is correct", function () { pm.response.to.have.body("response_body_string"); });
Check for a JSON value (检查JSON值)
pm.test("Your test name", function () { var jsonData = pm.response.json(); pm.expect(jsonData.value).to.eql(100); });
Content-Type is present (内容类型存在)
pm.test("Content-Type is present", function () { pm.response.to.have.header("Content-Type"); });
Response time is less than 200ms (响应时间小于200ms)
pm.test("Response time is less than 200ms", function () { pm.expect(pm.response.responseTime).to.be.below(200); });
Status code is 200 (状态码是200)
pm.test("Status code is 200", function () { pm.response.to.have.status(200); });
Code name contains a string (代码名称包含一个字符串)
pm.test("Status code name has string", function () { pm.response.to.have.status("Created"); });
Successful POST request status code (成功的POST请求状态码)
pm.test("Successful POST request", function () { pm.expect(pm.response.code).to.be.oneOf([201,202]); });
Use TinyValidator for JSON data (对于JSON数据使用TinyValidator)
var schema = { "items": { "type": "boolean" } }; var data1 = [true, false]; var data2 = [true, 123]; pm.test(‘Schema is valid‘, function() { pm.expect(tv4.validate(data1, schema)).to.be.true; pm.expect(tv4.validate(data2, schema)).to.be.true; });
Decode base64 encoded data (解码base64编码的数据)
var intermediate, base64Content, // assume this has a base64 encoded value rawContent = base64Content.slice(‘data:application/octet-stream;base64,‘.length); intermediate = CryptoJS.enc.Base64.parse(base64content); // CryptoJS is an inbuilt object, documented here: https://www.npmjs.com/package/crypto-js pm.test(‘Contents are valid‘, function() { pm.expect(CryptoJS.enc.Utf8.stringify(intermediate)).to.be.true; // a check for non-emptiness });
Send an asynchronous request (发送异步请求)
该功能既可以作为预先请求,也可以作为测试脚本使用。
pm.sendRequest("https://postman-echo.com/get", function (err, response) { console.log(response.json()); });
Convert XML body to a JSON object (将XML正文转换为JSON对象)
var jsonObject = xml2Json(responseBody);