Postman学习宝典（三）

Postman 入门3 - Newman

Newman

官方帮助文档地址

Newman 安装

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

1. 需要安装Node.js，并且Node.js版本需要>=V6

各系统安装Node.js可参照这个链接：https://www.runoob.com/nodejs/nodejs-install-setup.html

2.打开控制台，运行：

$ npm install -g newman   // 安装newman
$ npm install -g  newman-reporter-html //为了能生成html的测试报告，安装html report报告模块

3.可用如下命令校验是否安装成功：

Newman 执行脚本

Newman在3版本后做了比较大的改动，但是运行命令越来越简单，这里以v4.5版本为例：

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

run ：

后面跟上要执行的json文件或者URL（json 和 URL 都由postman导出生成），再后面跟一些参数，例如环境变量，测试报告，接口请求超时时间等等。

1.导出json格式文件

说到导出json文件大家应该常用，直接运行export就能导出json格式的文件到本地

2.下面讲讲如何导出URL格式的文件

点击集合三个点然后再点击Share Collection

在弹框中选择Collecttion Link便生成了URL，点击Copy To Clipboard复制链接到粘贴板

options：

newman下主要有两个操作一个-v和-h：

-v实际上是--version的缩写，用来查看newman的版本信息

-h实际上是--help的缩写，用来查看newman使用帮助信息

newman run有很多个options：

在dos下使用以下命令查看run下的操作

newman run --help

下面来讲讲比较常用的option：

-n：主要用来定义迭代次数，在运行集合或请求时需要循环的次数可使用-n number来定义

-d：在使用数据驱动方式时，定义提供的参数化文件（本地json或csv格式），数据文件运行多次迭代时，每次迭代使用其中一组变量

-e和-g：都是用来定义集合或者请求url的变量的，也是需要导出到本地，以文件的形式指定

 -r：用来定义输出报告的格式，一般默认的是cli，也就是客户端运行界面显示的格式，这里还执行另外三种格式html、json、junit（也就是xml格式），如果想一次输出多个格式的报告可以使用下面的命令

-r cli,html,json,junit

 -k：有些网站是采用的https协议，在http协议上增加了ssl协议安全加密，使用-k就能够轻松的跳过登录后弹出证书验证的情况

 --export：定义输出格式，后面的参数是输出路径，下面具体举几个例子：

 在实际应用中的格式：
 --reporter-[format]-export <path>

 --reporter-junit-export  C:\Desktop//使用xml格式输出报告到桌面

 --reporter-html-export  C:\Desktop//使用html格式输出报告到桌面

 --reporter-json-export  C:\Desktop//使用json格式输出报告到桌面

下面举几个完整性的例子做参考：

例子1，通过newman 运行postman导出的test1.json文件，忽略ssl验证，迭代4次，并生成多种测试报告（json，junit的xml，html）：

newman run C:\postman\test1.json -r cli,junit,html,json --reporter-json-export C:\postman\json_result.json --reporter-junit-export C:\postman\xml_result.xml --reporter-html-export C:\postman\html_result.html -k -n 

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

newman run https://www.getpostman.com/collections/10d6f9f4b681917bf258 -e C:\postman\env.json -d C:\postman\user.json -g C:\postman\globals.json --timeout-request 5000 --reporters cli,html --reporter-html-export C:\postman\htmlOut.html

结合Jenkins持续集成

平时做接口自动化，避免不了最后通过Jenkins做构建。既然Newman提供了控制台命令执行方式，那么像通过Jenkins来构建也就容易多了。

步骤一：在Jenkins 机器上安装Node.js、Newman

步骤二：搭建Jenkins环境，并新建个自由风格的Job

步骤三：构建选择Execute Windows batch command，并输入newman 运行命令

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