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：定义输出格式，后面的参数是输出路径，下面具体举几个例子：

1 在实际应用中的格式：
2 --reporter-[format]-export <path>
3 
4 --reporter-junit-export  C:\Desktop//使用xml格式输出报告到桌面
5 
6 --reporter-html-export  C:\Desktop//使用html格式输出报告到桌面
7 
8 --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 4

 

例子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 插件来生成测试报告。