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 插件來生成測試報告。