Postman+Newman 简介和简单使用（二）

Postman+Newman 简介和简单使用（二）

内置脚本说明：

1. 清除一个全局变量 Clear a global variable 
对应脚本： postman.clearGlobalVariable("variable_key"); 
参数：需要清除的变量的key

2.清除一个环境变量 Clear an environment variable 
对应脚本： postman.clearEnvironmentVariable("variable_key"); 
参数：需要清除的环境变量的key

3.response包含内容 Response body:Contains string 
对应脚本： tests["Body matches string"] =responseBody.has("string_you_want_to_search"); 
参数：预期内容

4.将xml格式的response转换成son格式 Response body:Convert XML body to a JSON Object 
对应脚本： var jsonObject = xml2Json(responseBody); 
参数：（默认不需要设置参数,为接口的response）需要转换的xml

5.response等于预期内容 Response body:Is equal to a string 
对应脚本： tests["Body is correct"] = responseBody === "response_body_string"; 
参数：预期response

6.json解析key的值进行校验 Response body:JSON value check 
对应脚本： tests["Args key contains argument passed as url parameter"] = 'test' in responseJSON.args 
参数：test替换被测的值，args替换被测的key

7.检查response的header信息是否有被测字段 Response headers:Content-Type header check 
对应脚本： tests["Content-Type is present"] = postman.getResponseHeader("Content-Type"); 
参数：预期header

8.响应时间判断 Response time is less than 200ms 
对应脚本： tests["Response time is less than 200ms"] = responseTime < 200; 
参数：响应时间

9.设置全局变量 Set an global variable 
对应脚本： postman.setGlobalVariable("variable_key", "variable_value"); 
参数：全局变量的键值

10.设置环境变量 Set an environment variable 
对应脚本： postman.setEnvironmentVariable("variable_key", "variable_value"); 
参数：环境变量的键值

11.判断状态码 Status code:Code is 200 
对应脚本： tests["Status code is 200"] = responseCode.code != 400; 
参数：状态码

12.检查code name 是否包含内容 Status code:Code name has string 
对应脚本： tests["Status code name has string"] = responseCode.name.has("Created"); 
参数：预期code name包含字符串

13.成功的post请求 Status code:Successful POST request 
对应脚本： tests["Successful POST request"] = responseCode.code === 201 || responseCode.code === 202;

 14.微小验证器 Use Tiny Validator for JSON data 
对应脚本： var schema = { "items": { "type": "boolean" } }; 
var data1 = [true, false]; var data2 = [true, 123]; 
console.log(tv4.error); tests["Valid Data1"] = tv4.validate(data1, schema); 
tests["Valid Data2"] = tv4.validate(data2, schema); 
参数：可以修改items里面的键值对来对应验证json的参数
 

使用Runner功能和外部数据

　　Postman 工具自带了Runner功能，用于批量运行脚本。在运行时还可以使用外部的CSV或者json文件来指定数据。
　　例如现在新建了如下两个外部数据，第一个保存为.json文件，第二个保存为.csv文件。

　　新建如下GET请求API，并放于单独一个文件夹中管理。接口请求中{{host}}便是用来获取上步新建的两个文件夹中的数据，{{}}中的名字对应json文件的key值，对应csv文件中的第一行值。

　　点击Runner按钮，打开Runner界面：

　　在新打开的窗口中，选着你要刚新建的文件夹名，选择你要运行的环境，运行的次数和在Data File中选择刚新建的外部json或者csv文件,并选取文件类型，点击Start Test，变开始逐条读取外部文件中的数据，进行运行。

Postman Interceptor

Interceptor 可以直接从浏览器中获取请求，并保存在Postman的History中。 这个插件可以大大缩短API配置的时间，同样Interceptor还有一个功能可以让Postman和Chrome浏览器共用Chrome的Cookies。

安装 Interceptor

　　Interceptor 同样是Chrome的一个插件，所以也可以从Chrome网上商店找到该插件: https://chrome.google.com/webstore/detail/postman-interceptor/aicmkgpgakddgnaphhhpliifpcfhicfo/support?hl=cn ，直接点击安装。安装完后会在Chrome 插件中找到下图标识。

使用 Interceptor

　　开启Interceptor插件，并设置你要抓取的网站请求

　　在Postman 上同样打开Interceptor

　　这时在Chrome浏览器上访问一些baidu相关域名就会自动被Postman抓取，并在Postman的History显示

Newman

官方帮助文档地址：https://www.npmjs.com/package/newman

Newman 安装

　　嗯，它需要安装，因为它不是音乐播放器！Newman是为Postman而生，专门用来运行Postman编写好的脚本。Newman安装步骤：

1. 需要安装nodejs，并配置好环境
2. 打开控制台，运行：npm install -g newman 

1. 校验是否安装成功，运行：newman --version

Newman 执行脚本

　　Newman在3版本后做了比较大的改动，但是运行命令越来越简单如下：

newman run <collection-file-source> [options]

run 后面跟上要执行的json文件或者URL（json 和 URL 都由postman导出生成），再后面跟一些参数，例如环境变量，测试报告，接口请求超时时间等等。最后给两个完整的例子做参考：
例子1，通过newman 运行postman导出的test1.json文件，并生成多种测试报告（json，junit的xml，html）：

newman run c:\test1.json --reporters cli,html,json,junit --reporter-json-export jsonOut.json --reporter-junit-export xmlOut.xml--reporter-html-export htmlOut.html

例子2，运行https://www.getpostman.com/collections/cb0cea0af1467c8008fb（postman生成的）中的所有api，并使用env.json作为环境变量和globals.json作为全局变量，并使用外部data.csv作为外部数据，最后设置了接口请求超时时间为5S 。

newman run https://www.getpostman.com/collections/cb0cea0af1467c8008fb --environment env.json --iteration-data data.csv --globals globals.json --timeout-request 5000

Jenkins 结合

　　平时做接口自动化，避免不了最后通过Jenkins做构建。既然Newman提供了控制台命令执行方式，那么像通过Jenkins来构建也就容易多了。
步骤一：在Jenkins 机器上安装Newman
步骤二：搭建Jenkins环境，并新建个自由风格的Job
步骤三：构建选择Execute Windows batch command，并输入newman 运行命令

步骤四：因为上面命令中构建会生成junit的xml报告，所以可以在构建后用Publish JUnit test result report 插件来生成测试报告。