【松勤軟體測試基礎】介面測試之Postman簡介

最新 03-01

一、基本功能

Postman的功能在在文檔中有介紹。不過文檔略啰嗦，這裡簡單介紹一下主界面，入門功能就都提到了。

Collections：在Postman中，Collection類似文件夾，可以把同一個項目的請求放在一個Collection里方便管理和分享，Collection裡面也可以再建文件夾。如果做API文檔的話，可以每個API對應一條請求，如果要把各種輸入都測到的話，就需要每條測試一條請求了。這裡我新建了一個example用於介紹整個流程，五個API對應五條請求。這個Collection可以通過https://www.getpostman.com/collections/96b64a7c604072e1e4ee導入你自己的Postman中。

上面的黑字註冊是請求的名字，如果有Request description的話會顯示在這下面。下面的藍字是保存起來的請求結果，點擊可以載入某次請求的參數和返回值。我會用這個功能給做客戶端的同事展示不同情況下的各種返回值。保存請求的按鈕在15.

選擇HTTP Method的地方，各種常見的不常見的非常全。

請求URL，兩層大括弧表示這是一個環境變數，可以在16的位置選擇當前的environment，環境變數就會被替換成該environment里variable的值。

點擊可以設置URL參數的key和value

點擊發送請求

點擊保存請求到Collection，如果要另存為的話，可以點擊右邊的下箭頭

設置鑒權參數，可以用OAuth之類的

自定義HTTP Header，有些因為Chrome願意不能自定義的需要另外裝一個插件Interceptor，在16上面一行的衛星那裡

設置Request body，13那裡顯示的就是body的內容

在發起請求之前執行的腳本，例如request body里的那兩個random變數，就是每次請求之前臨時生成的。

在收到response之後執行的測試，測試的結果會顯示在17的位置

有四種形式可以選擇，form-data主要用於上傳文件。x-www-form-urlencoded是表單常用的格式。raw可以用來上傳JSON數據

返回數據的格式，Pretty可以看到格式化後的JSON，Raw就是未經處理的數據，Preview可以預覽HTML頁面

點擊這裡把請求保存到2的位置

設置environment variables和global variables，點擊右邊的x可以快速查看當前的變數。

測試執行的結果，一共幾個測試，通過幾個。

這個界面就是免費版的主要內容，和其他API測試工具相比，已經足夠好用。如果要使用自動化測試，需要購買9.99美金的Jetpacks。

二、測試工具

測試工具主要包括三部分，在發起請求之前運行的Pre-request，在收到應答之後運行的Test，和一次運行所有請求的Collection Runner

1. Pre-request

Pre-request的編寫界面如下：

Pre-request和Test用的語言都是JavaScript，Postman在一個沙盒裡執行代碼，提供給用戶的庫和函數可以查看。而常用的功能都可以通過右邊的Code Snippets實現，點擊就可以插入到代碼區域。

可以看到Pre-request里常用的功能就兩種，設置環境變數和設置全局變數。這條請求的pre-request就是在註冊之前生成一個字元串作為隨機用戶名。

postman.setEnvironmentVariable("random_username",

("0000" + (Math.random()*Math.pow(36,4)

其他用法還包括在發起請求之前獲取當前的時間戳放在參數里：

postman.setEnvironmentVariable("unixtime_now",

Math.round(new Date().getTime()/1000));

當然也可以用來生成校驗串。總之，在發請求之前需要手動修改的東西，都可以考慮用腳本自動實現。

2. Test

Test的編寫界面如下：

和Pre-request相比，Test的Snippets就豐富多了，例如檢查狀態碼、檢查響應串、驗證JSON、檢查header、限制應答時間。

如果需要將伺服器響應的數據保存下來，用在後面的請求里，也需要在這一步做。

在圖中的Test里，我首先檢查了狀態碼為200，然後解析返回的JSON，把環境變數里的token設為JSON里的token。

3. Collection Runner

當編寫了很多測試之後，就可以使用Collection Runner來自動運行整個Collection了，入口就在主界面最上面一行的Runner。選好Collection、Environment，如果有需要還可以載入JSON和CSV作為數據源。點擊Start Test Run，就可以看到結果了。

這裡可以看到一共發起了5次請求，每個請求各有一個Test，全部Pass。（雖然最後一個請求的返回是403，但是這個請求的期望返回值就是403，所以也是Pass的）

三、示例

最後完整的看一下我用的常式。這個例子是一個非常簡單的小系統，用戶可以註冊並登錄，然後在系統里新建充值卡，並給這張卡充值。整個流程如下：

1.註冊

生成一個隨機字元串作為用戶名和昵稱

postman.setEnvironmentVariable("random_username", ("0000" + (Math.random()*Math.pow(36,4)

發起請求

POST /index.php/users HTTP/1.1Host: postmanexample.sinaapp.comCache-Control: no-cachePostman-Token: 76791813-aac2-71fb-cad4-3e737f37c4d0Content-Type:application/x-www-form-urlencodedusername=2mjk&password=123456&nickname=2mjk

運行測試、檢查結果

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

2.登錄

直接用剛才生成的環境變數發起請求

POST /index.php/authentication HTTP/1.1Host: postmanexample.sinaapp.comCache-Control: no-cachePostman-Token: aac7d0ac-e0e3-ecf2-39da-b8dca672e3d7Content-Type: application/x-www-form-urlencoded

username=2mjk&password=123456

運行測試、檢查結果，並將返回的token記錄下來

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

var data = JSON.parse(responseBody);

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

3.添加一張卡

先生成一個卡號和卡名

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

postman.setEnvironmentVariable("random_cardname", ("0000" + (Math.random()*Math.pow(36,4)

然後發起請求，這裡調用了剛才獲取到的Token，放在header的自定義欄位里作為鑒權（SAE不能用Authorization這個欄位，不清楚原因）

POST /index.php/cards HTTP/1.1Host: postmanexample.sinaapp.comX-Authorization: d4c4a0b7b36c73e7a13b7e24a596093bCache-Control: no-cachePostman-Token: d44d573f-f17a-366c-2cd7-1d5b8b709233Content-Type: application/x-www-form-urlencoded

cardno=1385526&desc=2mo8

運行測試

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

4.查詢剛才生成的卡

發起請求，調用了剛才生成的卡號

GET /index.php/cards/1385526 HTTP/1.1Host: postmanexample.sinaapp.comCache-Control: no-cachePostman-Token: 1e5aca57-c3bb-7404-2791-c639cd60b5c8

運行驗證，和剛才生成的卡名對比，並記錄新卡的ID

var data = JSON.parse(responseBody);

tests["check cardname"] = data.desc === environment.random_cardname;

postman.setEnvironmentVariable("new_card_id", data.id);

5.充值

發起請求，使用了剛才獲得的新卡ID

POST /index.php/deposit HTTP/1.1Host: postmanexample.sinaapp.comX-Authorization: d4c4a0b7b36c73e7a13b7e24a596093bCache-Control: no-cachePostman-Token: 388c95e0-b5ce-9bbf-5816-084db7523384Content-Type: application/x-www-form-urlencoded

cardid=1&amount=10

運行驗證（由於是新建的用戶，沒有餘額，無法給卡片充值，故返回403 Forbidden）

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

P.S. postmanexample.sinaapp.com這個網站是真實存在的，可以Import我上傳的Collection(https://www.getpostman.com/collections/96b64a7c604072e1e4ee )到你自己的Postman中，並設置環境變數url為http://postmanexample.sinaapp.com/index.php，就能運行這個Collection看效果了。