postman测试断言设置语法

Posted 2020-08-30

　　postman的基本介绍跟基本的用法，在此就不做过多赘述，主要是受限于时间，网上有很多大神总结的已经算是很详尽了，给出链接并感谢大神的辛苦与奉献；

　　postman基本用法：http://www.jianshu.com/p/13c8017bb5c8

　　这个链接相对来讲更全面系统，在页面下方有不同知识点的链接，直接点击链接学习系统的postman相关知识；

　　

　　我这边想说的是关于断言语法的东西，Postman测试沙箱是一个javascript执行环境，可以通过JS脚本来编写pre-request Script和test Script。pre-request Script可以用来修改一些默认参数。也就是说其实请求的预置脚本跟测试脚本都是用js语法来写的，如果熟悉js完全可以忽略本文，肯定能写出更牛的脚本；下面列出的是一些常用的预置脚本跟测试脚本，如果对js语法不了解，可能通过这样的积累也能起到想要的效果，语法也很简单，多敲几次就掌握其中的套路了；

 

Pre-request script：

　　

　　由右侧的选项也可以看到，Pre-request Script主要是设置一些全局变量跟环境变量，包括清除跟增加；

　　全局变量是在postman中所有的api都使用的变量，可以直接引用全局变量中的变量，而不用指定环境；

　　

　　点击右上角的眼睛可以看环境变量跟全局变量，当前没有选择环境变量，只有下面的Globals有值；

　　环境变量是特定的环境下引用的变量，必须要制定对应的环境才能引用到其中的变量；

　　

　　右上角Manage Enviroments可管理环境变量，包括新增、下载、删除等等，之后要自动跑api测试脚本，测试用例对应的环境变量集也要一并下载放到脚本里跑，否则用例中引用的环境变量会没有任何意义；如果我的解释太过模糊，请参考上面的链接。。。。。。

　　

　　选择一个环境后，在点击右上方的眼睛，可以看到全局变量的上方会有选中的环境变量集合；而pre-request script也很简单，就是删除全局变量或者环境变量，以及设置全局变量或者环境变量，简单写：

　　postman.setEnvironmentVariable("username", "postman");

　　这样在调用这个接口的时候，这个变量就会自动添加到环境变量中，可在相同环境的其他接口中调用这个变量，调用的方法为：{{username}}

　　常用的环境变量通常比较简单，也通常能应付一些场景，但是有些场景可能比较特殊，需要比如随机生成一个字符串作为用户名，或者需要发起请求前获取到当前的时间戳放到参数里，这样变量对应的值需要用到js中的函数：　　

　　1、注册之前生成一个字符串作为随机用户名：

　　postman.setEnvironmentVariable("random_username", ("0000" + (Math.random()*Math.pow(36,4) << 0).toString(36)).slice(-4));

　　2、在发起请求之前获取当前的时间戳放在参数里：

　　postman.setEnvironmentVariable("unixtime_now", Math.round(new Date().getTime()/1000));

　　其实一般的设置方法应该可以够用，若实在需要构造特殊场景的变量，那就请教熟悉javascript的同事吧；

 

Test script：

　　

 

　　

　　测试脚本右侧也有一些设置的选项，相信大家都能看懂什么意思，也能根据选项的意思大体晓得应该怎样设置测试断言，下面列出一些常用的测试断言：　

　　1、验证本次请求的状态码，即验证本次请求是否能调通；

　　tests["Status code is 200"] = responseCode.code === 200;

　　tests["Status code is 201"] = responseCode.code === 201;

　　其中的tests["Status code is 201"] 只是起到断言开始的作用，并且断言的描述为"Status code is 200"，或可任意写合适的描述，运行测试或跑自动化脚本时，在测试报告中会表示出"Status code is 200"该断言是否判定成功；如：

　　

 

 

　　2、验证返回相应中的字段值：

　　var jsonData = JSON.parse(responseBody);

　　tests["Check respose value err_code"] = jsonData.err_code === 0;

　　先声明一个变量jsonData，调用JSON.parse()方法将responseBody转换成json的标准格式并赋值给变量jsonData，然后判断jsonData中的err_code是否为0；

　　javascript中===表示全等；真实的响应结果如下：

　　

 

 

　　3、把环境变量里的token设为JSON里的token

　　postman.setEnvironmentVariable("username", jsonData.username);

　　这一句是将相应中的"username"字段设置为环境变量，在同环境其他的接口中，可以调用这个变量；另外一点，变量值取得是jsonData.username，前提是在这个断言之前已经执行var jsonData = JSON.parse(responseBody);即变量jsonData是已经声明并赋值了得，否则应该换成responseBody.username，但responseBody可能不是json格式的，直接用可能不准确，所以最好还是先将responseBody转换成标准json格式，当然变量jsonData名可以任意，直接取为body也没有问题，那设置环境变量的值为body.username，但变量名不能与已经有的字段名相同；

　　

 

　　4、响应时间小于500ms

　　tests[‘Response time is less than 500ms‘] = responseTime < 500;

　　在postman中给的是相应时间小于200ms，500ms跟200ms相差不大，具体应该多少，凭君喜好，甚至可以更大，单位是ms；

 

　　5、验证响应报文的JSON格式：

　　//最简单的格式验证

　　var schema = {

　　　　properties: {

　　　　　　err_code: {type: ‘int‘},

　　　　　　err_msg: {type: ‘string‘}

　　　　}

　　};

　　tests["Valid data schema"] = tv4.validate(responseBody, schema);

　　先声明一个变量，在构造一个json格式赋值给变量schema，当然这个构造的json格式，就应该是接口返回的理论上的json格式，通过运行接口获取实际返回的responseBody与构造的标准json格式对比，看是否符合；这里也用到了tv4工具库中的validate()方法来对比json格式；

 

　　//带有字段描述的响应json格式验证

　　var schema = {

　　　　properties:{

　　　　　　"err_code":{

　　　　　　　　"description": "The code of response!",

　　　　　　　　"type": "int"

　　　　　　},

　　　　　　"err_msg":{

　　　　　　　　"description": "The message of response!",

　　　　　　　　"type": "string"

　　　　　　}

　　　　}

　　};

　　tests["valid response schema"] = tv4.validate(responseBody, schema);

 

　　6、验证相应报文中是否包含某字段：

　　tests["body has status"] = jsonData.status = true;

 

　　7、先判断某字段是否存在，若存在则设置环境变量，若不存在则不设置：

　　if (jsonData.status) {

　　　　tests["body has status"] = true;

　　　　postman.setEnvironmentVariable("status", jsonData.status);

　　}

　　else {

　　　　tests["body has status"] = false;

　　}

 

 

Pre-request script 与Test script相互调用：

 

　　1、在pre-request script中随机生成cardno和cardname，并设置成环境变量：

　　postman.setEnvironmentVariable("random_cardno", Math.round(Math.random()*9999999));

　　postman.setEnvironmentVariable("random_cardname", ("0000" + (Math.random()*Math.pow(36,4) << 0).toString(36)).slice(-4));

 

　　发起请求后，test script调用环境变量验证相应中的cardname是否正确，同时记录新卡id：

　　var data = JSON.parse(responseBody); tests["check cardname"] = data.desc === environment.random_cardname; 　　　　　　　    　　　　                        postman.setEnvironmentVariable("new_card_id", data.id);

 

　　2、将某请求获取到的token跟user_id设置为环境变量，以供后续使用：

　　

　　在Test script编辑器中键入如下脚本：

　　var data = JSON.parse(responseBody);

　　if (data.token) {

　　　　 tests["Body has token"] = true;

　　　　postman.setEnvironmentVariable("user_id", data.user_id);

　　      postman.setEnvironmentVariable("token", data.token);

　　}

　　else {

　　　　tests["Body has token"] = false;

　　}

　　如果上面的测试是在主窗口或者集合运行器中执行，那么 user_id 和 token 会自动地被添加到环境变量中。

　　发送一个POST请求到 {{url}}/blog/posts ，并将 user_id 和 token 添加在URL参数中：

　　

　

　　调用环境中设置的环境变量使用: {{EnviromentValue}}

　　请求成功的话将返回一个带有post_id的JSON,将文章ID保存到环境变量:

　　var data = JSON.parse(responseBody);

　　if (data.post_id) {

　　　　tests["post_id found"] = true;

　　　　postman.setEnvironmentVariable("post_id", data.post_id);

　　}

　　else {

　　　　tests["post_id found"] = false;

　　}

 

　　将通过上面返回的文章ID来获取我们创建的文章。这里我们将用到Postman内置的 tv4 JSON 验证器来检查服务器响应的JSON。

　　创建一个GET请求到 {{url}}/blog/posts/{{post_id}}，并将下面这段代码添加到测试编辑器中：

　　var schema = {

　　　　"type": "object",

　　　　"properties": {

　　　　　　"content": "string",

　　　　　　"created_at": "integer",

　　　　　　"id": "integer" },

　　　　"required": ["content", "created_at", "id"]

　　};

　　var data = JSON.parse(responseBody);

　　var result = tv4.validateResult(data, schema);

　　tests["Valid schema"] = result.valid;

　　

 

结语：

 　　js语法规则很多，但设置pre-request script跟test script常用的也没有很多，认真体会上面列出的常用断言的语法规则，才能更好的使用；当需要构造特殊场景的时候，没办法请教大神吧；

　　

 

参考资料：

　　

https://segmentfault.com/a/1190000005055899