自動化接口測試之Postman

一、Postman介紹

Postman官網(wǎng)上這樣介紹它:"Manage all of your organization's APIs in Postman, with the industry's most complete API development environment."看的出來Postman是功能強大的專門針對API測試的工具
?
Postman 提供功能強大的 Web API 和 HTTP 請求的調(diào)試,它能夠發(fā)送任何類型的HTTP 請求 (GET, POST, PUT, DELETE...),并且能附帶任何數(shù)量的參數(shù)和 Headers。不僅如此,它還提供測試數(shù)據(jù)和環(huán)境配置數(shù)據(jù)的導(dǎo)入導(dǎo)出,付費的 Post Cloud 用戶還能夠創(chuàng)建自己的 Team Library 用來團隊協(xié)作式的測試,并能夠?qū)⒆约旱臏y試收藏夾和用例數(shù)據(jù)分享給團隊。

二、Postman下載及安裝

Postman有2種安裝方式,一種是作為Chrome的拓展程序,另一種是客戶端形式,建議使用客戶端的方式安裝
?

  1. Postman下載
    官網(wǎng)下載地址:https://www.getpostman.com/downloads/

  2. 安裝過程
    默認安裝即可,安裝完成后,建議注冊賬號便于以后將腳本保存到云端

三、Postman功能視圖

詳細功能可以參考Postman官方 文檔,
打開軟件,就可以看到Postman主界面,如下圖所示:

postman界面.png

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

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

  3. 選擇HTTP Method的地方,各種常見的不常見的非常全。

  4. 請求URL,兩層大括號表示這是一個環(huán)境變量,可以在16的位置選擇當(dāng)前的environment,環(huán)境變量就會被替換成該environment里variable的值。

  5. 點擊可以設(shè)置URL參數(shù)的key和value

  6. 點擊發(fā)送請求

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

  8. 設(shè)置鑒權(quán)參數(shù),可以用OAuth之類的

  9. 自定義HTTP Header,有些因為Chrome愿意不能自定義的需要另外裝一個插件Interceptor,在16上面一行的衛(wèi)星那里

  10. 設(shè)置Request body,13那里顯示的就是body的內(nèi)容

  11. 在發(fā)起請求之前執(zhí)行的腳本,例如request body里的那兩個random變量,就是每次請求之前臨時生成的。

  12. 在收到response之后執(zhí)行的測試,測試的結(jié)果會顯示在17的位置

  13. 有四種形式可以選擇,form-data主要用于上傳文件。x-www-form-urlencoded是表單常用的格式。raw可以用來上傳JSON數(shù)據(jù)

  14. 返回數(shù)據(jù)的格式,Pretty可以看到格式化后的JSON,Raw就是未經(jīng)處理的數(shù)據(jù),Preview可以預(yù)覽HTML頁面

  15. 點擊這里把請求保存到2的位置

  16. 設(shè)置environment variables和global variables,點擊右邊的x可以快速查看當(dāng)前的變量。

  17. 測試執(zhí)行的結(jié)果,一共幾個測試,通過幾個。

四、測試工具

測試工具主要包括三部分,在發(fā)起請求之前運行的Pre-request,在收到應(yīng)答之后運行的Test,和一次運行所有請求的Collection Runner

  1. Pre-request
    預(yù)請求腳本是與在發(fā)送請求之前執(zhí)行的收集請求相關(guān)聯(lián)的代碼片段。


    pre.png

Pre-request和Test用的語言都是JavaScript,Postman在一個沙盒里執(zhí)行代碼,提供給用戶的庫和函數(shù)可以在這里查看。而常用的功能都可以通過右邊的Code Snippets實現(xiàn),點擊就可以插入到代碼區(qū)域。

  1. Test
    使用Postman,您可以使用JavaScript語言為每個請求編寫和運行測試.


    test.png

?

測試例子
設(shè)置環(huán)境變量

pm.environment.set("variable_key", "variable_value");

獲取環(huán)境變量

pm.environment.get("variable_key");

獲取環(huán)境變量(其值是字符串化對象)

var array = JSON.parse(pm.environment.get("array"));
var obj = JSON.parse(pm.environment.get("obj"));

清除環(huán)境變量

pm.environment.unset("variable_key");

設(shè)置全局變量

pm.globals.set("variable_key", "variable_value");

獲取全局變量

pm.globals.get("variable_key");

清除全局變量

pm.globals.unset("variable_key");

得到一個變量
此函數(shù)在全局變量和活動環(huán)境中搜索變量。

pm.variables.get("variable_key");

檢查響應(yīng)主體是否包含字符串

pm.test("Body matches string", function () {
    pm.expect(pm.response.text()).to.include("string_you_want_to_search");
});

檢查響應(yīng)主體是否等于字符串

pm.test("Body is correct", function () {
    pm.response.to.have.body("response_body_string");
});

檢查JSON值

pm.test("Your test name", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.value).to.eql(100);
});
//var jsonData = JSON.parse(responseBody);
//tests["list"] = jsonData["lists"][0] == "11";

內(nèi)容類型存在

pm.test("Content-Type is present", function () {
    pm.response.to.have.header("Content-Type");
});

響應(yīng)時間小于200毫秒

pm.test("Response time is less than 200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

代碼名稱包含一個字符串

pm.test("Status code name has string", function () {
    pm.response.to.have.status("Created");
});

成功的POST請求狀態(tài)代碼

pm.test("Successful POST request", function () {
    pm.expect(pm.response.code).to.be.oneOf([201,202]);
});

將XML主體轉(zhuǎn)換為JSON對象

var jsonObject = xml2Json(responseBody);

獲取HTML并取出其中的值

//獲取HTML
const $ = cheerio.load(responseBody);

//獲取input標簽中name屬性值為SignValue的數(shù)據(jù)中屬性為value的值
var signvalue=$('input[name=SignValue]').attr('value');

//
//獲取textarea標簽中name值為SignValue的數(shù)據(jù)中文本屬性text的值
var signvalue=$('textarea[name=SignValue]').text();

?

  1. Collection Runner
    當(dāng)編寫了很多測試之后,就可以使用Collection Runner來自動運行整個Collection了,入口就在主界面最上面一行的Runner。選好Collection、Environment,如果有需要還可以載入JSON和CSV作為數(shù)據(jù)源。點擊Start Run,就可以看到結(jié)果了。


    Coo.png

五、變化的參數(shù)

  1. 使用變量
    現(xiàn)在使用參數(shù)都是寫死的, 那么如果想要測試賬號密碼參數(shù)使用其它值有沒有異常怎么辦呢?
    這里就需要使用變量
    引用變量的語法:{{變量名}}
    Pre-request Script 和 Tests都可以設(shè)置變量,區(qū)別在于:Pre-request Script 中的腳本是在執(zhí)行請求之前運行,而Tests 中的腳本則是在請求完成之后執(zhí)行。
  2. 測試數(shù)據(jù)集
    在執(zhí)行Collection Runner時可以選擇CSV或json格式的文件作為測試數(shù)據(jù)集
    CSV文件格式:


    ![json.png](https://upload-images.jianshu.io/upload_images/17564771-de1d9b5fcfa29a63.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

JSON文件格式:


json.png

在執(zhí)行Collection Runner時使用CSV/JSON文件


runn.png
  1. 定期任務(wù)
    Postman 提供了一個 Monitors (監(jiān)視器)功能,支持我們提交一個測試任務(wù),按照設(shè)置的定時器進行運行,如每小時測試一次,具體操作如下:


    mo.png

    hour.png

?

六、接口依賴的問題

  1. 接口執(zhí)行順序
    首先,說明一下,接下來說的接口都是默認屬于同一個集合 (Collections) 中的。
    接口的執(zhí)行順序其實就是按照這邊目錄中的順序(從上到下);所以有了這個默認的執(zhí)行順序后,那么我們便可以把需要優(yōu)先執(zhí)行的接口放前面即可,比如把“登錄接口”放在第一個。
  2. 自定義執(zhí)行順序
    當(dāng)然,如果只有默認的一個執(zhí)行順序的話,通常沒法滿足我們復(fù)雜的業(yè)務(wù)需求,所以 Postman 為我們提供了一個函數(shù):postman.setNextRequest("填寫你要跳轉(zhuǎn)的接口名")
    我們可以在 接口的 Tests 功能區(qū)中執(zhí)行跳轉(zhuǎn)代碼,如:


    next.png

這里需要注意幾點:

  • postman.setNextRequest() 只在運行集合測試的時候生效,也就是說我們單獨運行 (Send) 接口 時,函數(shù)是不起作用的。
  • 當(dāng)我們運行集合測試成功從 Request1 -> Request3 后,如果 Request3 后面還有接口,那么后面的接口仍然繼續(xù)按默認順序執(zhí)行,即圖中的接口 Request4 仍會被執(zhí)行。
  • 指定的跳轉(zhuǎn)接口必須屬于同一個集合中。
  • setNextRequest() 函數(shù)不管在 Tests 腳本中何處被調(diào)用,它都只在當(dāng)前腳本最后才被真正執(zhí)行。比如我們將圖中的第二行與第一行互調(diào)后,那么在運行跳轉(zhuǎn)函數(shù)后第二行代碼仍會被執(zhí)行。
  1. 解決依賴的思路
  • 保證 Request1 在 Request3 之前被運行
  • 將 Request1 返回的 access_token 的值添加到環(huán)境變量"參數(shù)集"中。
  • Request3 在請求時引用 access_token 的值

?

五、參考資料

http://bayescafe.com/tools/use-postman-to-test-api-automatically.html
https://learning.getpostman.com/docs/postman/scripts/test_examples/
https://blog.csdn.net/cai_iac/article/details/81030619

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容