Postman請求運行順序及Workflow

作為一款接口調試利器, Postman的更新迭代速度很快, 不斷加入了很多新的功能.使的api設計,測試,監控, Mock,以及團隊協作更加方便.

修改執行順序

在遇到有接口依賴的情況, 我們往往需要接口按順序執行, 之前可以通過在一個請求的Pre-request Scripts中使用pm.sendRequest發送所依賴的請求來實現, 新版本Postman在Run Collection中我們可以修改請求的執行順序, 如下圖:

這里將所有的接口放到一個Collection請求集合中, 在"百度獲取token"這個請求的Tests腳本中中,將access_token存為全局變量, 以供"百度orc"使用.
我們可以直接拖動, 改變默認Collection的執行順序, 也可以選擇不運行哪些請求.

Workflow工作流

除了在Run Collection時調整順序外,我們還可以通過postman.setNextRequest("同Collection下保存的請求名");來手動控制請求的跳轉.

順序結構

如下圖, 新建一個Collection, 新增A, B, C, D, E, F 5個請求, 在請求A的Tests腳本中添加

postman.setNextRequest("D");

以使A執行完下一個執行D請求.



從上圖我們可以看出, 實際上跳過了請求B, C, 直接跳轉到D請求.

注意: 如果D請求在運行時未勾選, 則只會運行A請求

分支結構

通常情況下,我們可以使用if判斷來控制流程跳轉, 比如, 通過判斷A請求是否成功來分別跳轉到D請求或B請求.

var jsonData = pm.response.json()

if(jsonData.args.a == 'a'){
    postman.setNextRequest("D");
}
else{
    postman.setNextRequest("B");
}

循環結構

我們可以通過在最后一個請求中使用postman.setNextRequest(), 之前的請求, 來完成一個循環, 比如在F請求使用postman.setNextRequest("A"), 就會無限循環的執行下去, 如下圖所示:

一般來說, 循環中一定要設置中止條件, 一般通過if判斷是否postman.setNextRequest()來控制是否繼續循環.

示例: 異步接口輪詢

我們可以用一個postman.setNextRequest指向自身的請求來完成異步接口的輪詢.

1. 新建一個Collection, 新建一個"創建訂單接口", 請求為:

http://115.28.108.130:5000/api/order/create/?
user_id=123&goods_id=123&num=2&amount=20.0

這是一個異步接口, 接口會返回一個order_id用於查詢訂單結果. 我們在Tests中,將獲取到的order_id存為全局變量以供下一個接口使用, 如下圖所示:

var jsonData = pm.response.json()
pm.globals.set("order_id", jsonData.order_id);

2. 新建一個"獲取訂單結果"接口, 請求為:

http://115.28.108.130:5000/api/order/get_result/?order_id={{order_id}}

這是一個獲取訂單接口, 訂單不確定多長時間創建好, 如果訂單在創建過程中則返回"{}", 如果創建成功則返回:

{
    "amount": "20.0",
    "goods_id": "123",
    "num": "2",
    "user_id": "123"
}

我們在Tests腳本中設置輪詢條件, 下個請求指向自身如下:

if(pm.response.text() == "{}\n"){
    postman.setNextRequest("獲取訂單結果");
}

Run Collection 我們發現, "獲取訂單結果"請求被快速的請求, 直到停止, 實際上我們還需要設置一個輪詢間隔, 我們將postman.setNextRequest放到一個函數種,然后用setTimeout來延遲一定時間運行.

function loop(){
    postman.setNextRequest("獲取訂單結果")
}

if(pm.response.text() == "{}\n"){
    setTimeout(loop, 5000);  // 設置間隔5s
}

如下圖, "獲取訂單結果"請求會5妙執行一次, 知道訂單處理完成.

注意:

1. 一般我們還要設置最大輪詢次數或最大輪詢時間, 來防止接口始終返回"{}\n", 導致輪詢無法中止(可以通過使用整數變量自增完成).
2. 在輪詢完也可以加上斷言(寫到else中)