散文網(wǎng) » 科技 »學(xué)習(xí) » 一文搞定 Postman 接口自動(dòng)化測(cè)試

一文搞定 Postman 接口自動(dòng)化測(cè)試

2022-10-28 09:59 作者:愛測(cè)軟件測(cè)試 0人讀過 | 我要投稿

文末獲取測(cè)試開發(fā)進(jìn)階指南 -
本文適合已經(jīng)掌握 Postman 基本用法的讀者，即對(duì)接口相關(guān)概念有一定了解、已經(jīng)會(huì)使用 Postman 進(jìn)行模擬請(qǐng)求等基本操作。
工作環(huán)境與版本：
Window 7（64位）
Postman （Chrome App v5.5.3）
P.S. 不同版本頁面 UI 和部分功能位置會(huì)有點(diǎn)不同，不過影響不大。
首先我們來思考一下，如果要達(dá)到自動(dòng)化接口測(cè)試效果，在基本的模擬請(qǐng)求上還需要做哪些呢？
我粗略概括為 3 個(gè)問題（歡迎在評(píng)論區(qū)留言更多補(bǔ)充建議）：

如何判斷接口是否請(qǐng)求成功？
如何進(jìn)行接口批量、定期測(cè)試？
如何處理依賴接口問題（比如商品下單的接口必須要求先登錄）？
所以，接下來就主要分為 3 個(gè)部分，介紹如何解決這 3 個(gè)問題。
首先，既然是自動(dòng)化測(cè)試，那么我們肯定需要通過工具 Postman 或者代碼，幫我們直接判斷結(jié)果是否符合預(yù)期。那么在接口測(cè)試上，大體就兩個(gè)思路：
判斷請(qǐng)求返回的 code 是否符合預(yù)期
判斷請(qǐng)求返回的內(nèi)容中是否包含預(yù)期的內(nèi)容（關(guān)鍵字）
接下來我們看看如何利用 Postman 來解決上述的問題：

在 Postman 中相關(guān)的功能在非常顯眼的地方，Tests 功能的使用需要我們有一定的編程語言基礎(chǔ)，目前支持的腳本語言即為 JavaScript 。但比較好的一點(diǎn)是，我們不需要再去考慮上下文問題以及運(yùn)行環(huán)境的問題，也就是說我們只需要在這邊完成結(jié)果邏輯判斷的代碼塊即可。
而 Postman 還為我們提供了一些常用的代碼模板，在 Tests 面板右邊的 SNIPPETS 功能區(qū)中，所以對(duì) JavaScript 不大了解問題也不大。代碼編寫相關(guān)將在下文進(jìn)行具體介紹。
先看上圖的代碼部分，我們可以發(fā)現(xiàn) responseCode 、 responseBody 和 tests 三個(gè)變量（可直接使用）：

responseCode ：包含請(qǐng)求的返回的狀態(tài)信息(如：code)。
responseBody：為接口請(qǐng)求放回的數(shù)據(jù)內(nèi)容（類型為字符串）。
tests ：為鍵值對(duì)形式，用于表示我們的測(cè)試結(jié)果是成功與否，最終展示在 Test Results 中。
key ：（如：code 200）我們可以用來當(dāng)做結(jié)果的一個(gè)描述。
value：其值為布爾型，ture 表示測(cè)試通過， false 表示測(cè)試失敗。
所以上述代碼應(yīng)該不難理解了，而有了返回結(jié)果的數(shù)據(jù)以及表示結(jié)果成功與否的方式，那么我們“接口結(jié)果判斷”的問題也就基本解決了。
另外還有幾個(gè)比較常用的：
responseTime ：請(qǐng)求所耗時(shí)長(zhǎng)
postman ：可以做的比較多，比如
獲取返回?cái)?shù)據(jù)的頭部信息：
postman.getResponseHeader("")
設(shè)置全局變量：
postman.setGlobalVariable("variable_key", "variable_value");
更多功能可以查看官方文檔。
Postman 在 SNIPPETS 功能區(qū)中為我們提供的代碼模板已經(jīng)能解決大部分情況了，以下先挑幾個(gè)跟結(jié)果判斷相關(guān)的進(jìn)行講解：
Status code : Code is 200
Response body: Contains string
Response body: is equal to string
Response body: JSON value check
Response time is less than 200ms
以上介紹的這些基本已經(jīng)足夠完成對(duì)單一接口的測(cè)試了，但我們知道如果沒有批量、定時(shí)任務(wù), 那么這些都將毫無意義，所以繼續(xù) …
想要進(jìn)行接口的批量測(cè)試、管理，那么我們需要將待測(cè)試的接口全部都保存到同一個(gè)集合（Collections）中，你可以認(rèn)為就是保存到同一個(gè)文件夾中。先看看 Postman 中的操作步驟：

通過以上步驟，我們得到一個(gè)待測(cè)的接口集合，為了簡(jiǎn)化情況，我這邊每個(gè)接口成功與否的條件都是用 code 是否為 200 來判斷：
以上準(zhǔn)備就緒后，我們就可以開始批量運(yùn)行接口進(jìn)行測(cè)試了：

點(diǎn)擊Run 后，會(huì)新打開一個(gè)頁面：

Environment ：用于切換接口運(yùn)行的環(huán)境，這里先不管，后面再講

Iteration ：用于設(shè)置接口一共要運(yùn)行的次數(shù)。
Delay : 設(shè)置每次運(yùn)行接口之間的時(shí)間間隔，單位為毫秒。
Data File : 上傳測(cè)試數(shù)據(jù)文件（下文單獨(dú)講）
我們已經(jīng)了解了，如何讓多個(gè)接口循環(huán)運(yùn)行多次，但是現(xiàn)在有個(gè)問題，按目前這個(gè)步驟，每次運(yùn)行時(shí)接口的參數(shù)都是一樣的，那么就算我們運(yùn)行個(gè)100次、1000次意義也不大。
先看看我們寫好的一個(gè)登錄功能的接口：

現(xiàn)在登錄的賬號(hào)和密碼參數(shù)都是寫死的，也就是不過我們執(zhí)行多少次，都是拿這個(gè)賬號(hào)去測(cè)試。那么如果想要測(cè)試賬號(hào)密碼參數(shù)使用其它值有沒有異常怎么辦呢？（想要每次都手動(dòng)改的可以跳過這部分 /手動(dòng)滑稽）這里我們先簡(jiǎn)單講一下在 Postman 中使用如何“變量”，如下圖：

引用一個(gè)變量的語法：{{變量名}}，圖中可以看到，我們將賬戶和密碼字段的參數(shù)值都設(shè)置為變量：{{username}} 、{{password}} 。修改完直接點(diǎn)擊運(yùn)行（Send）當(dāng)然是不行的，因?yàn)槟壳斑@兩個(gè)變量還未被賦值，不過我們可以在 Pre-request Script 面板中進(jìn)行賦值操作：
Pre-request Script 與 Tests 類似，區(qū)別在于：Pre-request Script 中的腳本是在執(zhí)行請(qǐng)求之前運(yùn)行，而Tests 中的腳本則是在請(qǐng)求完成之后執(zhí)行。所以，我們可以在 Pre-request Script 功能區(qū)中用腳本先個(gè)上面兩個(gè)變量進(jìn)行賦值，如:
但是用 Pre-request Script 進(jìn)行賦值操作仍然不能解決我們的問題，因?yàn)榘凑者@種寫法，不論運(yùn)行多少次其實(shí)都還是用固定（寫死）的數(shù)據(jù)進(jìn)行測(cè)試。當(dāng)然既然是腳本語言，也會(huì)有更靈活的用法，這邊先不將。
接下來我們講講 Data File , 在運(yùn)行集合前的這個(gè)選項(xiàng)就是用來上傳測(cè)試數(shù)據(jù)（文件）以賦值給相應(yīng)變量的。我們先以 CSV 格式的測(cè)試數(shù)據(jù)為例：
數(shù)據(jù)格式類似表格，第一行表示對(duì)應(yīng)的變量名，下面 4 行表示 4 組賬號(hào)密碼數(shù)據(jù)（其中兩組為正確數(shù)據(jù)），我們保存一份內(nèi)容為上述示例數(shù)據(jù)后綴名為.csv 的文件后，再次開始測(cè)試看看效果，我們選擇運(yùn)行次數(shù)為 4 （對(duì)應(yīng) 4 組測(cè)試數(shù)據(jù)）、選擇對(duì)應(yīng)的 CSV 文件運(yùn)行后，可以看到我們的結(jié)果確實(shí)如我們的預(yù)期。接口 Request 運(yùn)行的結(jié)果為兩次成功兩次失敗，也就是每一次運(yùn)行都賦值了不同的賬號(hào)密碼的測(cè)試數(shù)據(jù) （在最新的桌面客戶端版本中可以看到每次具體的請(qǐng)求情況，這邊就不再細(xì)說了）。
如果使用 Json 文件的話，那么格式如下：
Postman 提供了一個(gè) Monitors (監(jiān)視器)功能，支持我們提交一個(gè)測(cè)試任務(wù)，按照設(shè)置的定時(shí)器進(jìn)行運(yùn)行，如每小時(shí)測(cè)試一次，具體操作如下：

講完接口結(jié)果判斷和集合批量測(cè)試后，我們?cè)賮砜纯幢容^復(fù)雜的情況，即依賴請(qǐng)求問題，比如我們的購物下訂單接口要求必須先登錄后才可訪問。但大部分依賴問題其實(shí)本質(zhì)上就是一個(gè)接口間數(shù)據(jù)傳遞的問題，比如調(diào)用登錄接口后返回一個(gè)標(biāo)識(shí)，假設(shè)為 token ，那么我們請(qǐng)求下訂單接口時(shí)只要一起攜帶 token 參數(shù)進(jìn)行請(qǐng)求即可。所以，問題變?yōu)椋?/p>

保證接口調(diào)用順序
將接口A返回的數(shù)據(jù)傳遞給后續(xù)的接口B、C、D
首先，說明一下，接下來說的接口都是默認(rèn)屬于同一個(gè)集合 (Collections) 中的。
還是以我們上文中創(chuàng)建好接口集合為例，如果你有注意我們執(zhí)行批量測(cè)試的結(jié)果，就會(huì)發(fā)現(xiàn)接口的執(zhí)行順序其實(shí)就是按照這邊目錄中的順序（從上到下），即： Request1 → Request2 → Request3。

所以有了這個(gè)默認(rèn)的執(zhí)行順序后，那么我們便可以把需要優(yōu)先執(zhí)行的接口放前面即可，比如把“登錄接口”放在第一個(gè)。
當(dāng)然，如果只有默認(rèn)的一個(gè)執(zhí)行順序的話，通常沒法滿足我們復(fù)雜的業(yè)務(wù)需求，所以 Postman 為我們提供了一個(gè)函數(shù)：postman.setNextRequest(“填寫你要跳轉(zhuǎn)的接口名”) ，支持我們跳轉(zhuǎn)到指定接口繼續(xù)執(zhí)行，舉個(gè)例子：
我們?cè)谶\(yùn)行完 Request1 接口成功后，不需要再運(yùn)行 Request2 而是直接跳至 Request3 ，那么我可以在 Request1 接口的 Tests 功能區(qū)中執(zhí)行跳轉(zhuǎn)代碼，如：

這里需要注意幾點(diǎn)：

postman.setNextRequest() 只在運(yùn)行集合測(cè)試的時(shí)候生效，也就是說我們單獨(dú)運(yùn)行 (Send) 接口Request1 時(shí)，函數(shù)是不起作用的。
當(dāng)我們運(yùn)行集合測(cè)試成功從 Request1 → Request3 后，如果 Request3 后面還有接口，那么后面的接口仍然繼續(xù)按默認(rèn)順序執(zhí)行，即圖中的接口 Request4 仍會(huì)被執(zhí)行。
指定的跳轉(zhuǎn)接口必須屬于同一個(gè)集合中。
setNextRequest() 函數(shù)不管在 Tests 腳本中何處被調(diào)用，它都只在當(dāng)前腳本最后才被真正執(zhí)行。比如我們將圖中的第二行與第一行互調(diào)后，那么在運(yùn)行跳轉(zhuǎn)函數(shù)后第二行代碼仍會(huì)被執(zhí)行。
所以，利用 setNextRequest() 函數(shù)，我們便可以按照條件跳過不必要的接口，或者建立我們自己的一個(gè)邏輯測(cè)試。
在講數(shù)據(jù)傳遞前，先聊聊 Postman 中全局變量、環(huán)境切換的使用。
全局變量的概念其實(shí)我們?cè)谏衔闹兄v Pre-request Script 時(shí)有簡(jiǎn)單提到，也就是說我們可以通過腳本代碼來設(shè)置全局變量，我們可以看看運(yùn)行上文的腳本后的效果：
我們可以看到運(yùn)行后，username 和 password 兩個(gè)變量已經(jīng)被成功保存下來，那么我們?cè)谌我饨涌谥斜愣伎梢酝ㄟ^變量引用的語法如：{{username}} 來使用它們。
另外，Postman 不僅支持代碼設(shè)置全局變量的方式，它還支持可視化操作：

進(jìn)入對(duì)應(yīng)界面后，便可直接進(jìn)行管理：

通常情況下，我們的接口都會(huì)分為測(cè)試版本和線上版本（或者更多），而他們的區(qū)別可能僅是 ULR 不同，那么全局變量便不大合適解決這個(gè)問題。

可能你已經(jīng)注意到，上圖中我已經(jīng)建有幾個(gè)不同環(huán)境的參數(shù)“集合”了，再看一下：

我在每個(gè)環(huán)境中都創(chuàng)建了一個(gè) host 參數(shù)，如：

當(dāng)然，我們的環(huán)境參數(shù)也可以通過腳本的方式來進(jìn)行設(shè)置，函數(shù)為：

環(huán)境“參數(shù)集” 中的參數(shù)使用方式和全局變量一致，如圖中 {{host}} ，不同環(huán)境的切換見下圖：

掌握以上的預(yù)備知識(shí)后，我們開始看看如何用 Postman 解決存在依賴關(guān)系的接口測(cè)試。

我們的接口 Request1 為登錄接口，登錄成功將會(huì)返回一個(gè) access_token 字段作為標(biāo)識(shí)（已實(shí)現(xiàn)）。那么假設(shè)接口 Request3 為一個(gè)下訂單的接口，需要攜帶登錄返回的 access_token 才能正常訪問。