一粱甫、Postman介紹
Postman官網(wǎng)上這樣介紹它:"Manage all of your organization's APIs in Postman, with the industry's most complete API development environment."看的出來Postman是功能強(qiáng)大的專門針對API測試的工具
?
Postman 提供功能強(qiáng)大的 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 用來團(tuán)隊協(xié)作式的測試溯祸,并能夠?qū)⒆约旱臏y試收藏夾和用例數(shù)據(jù)分享給團(tuán)隊。
二本姥、Postman下載及安裝
Postman有2種安裝方式肩袍,一種是作為Chrome的拓展程序,另一種是客戶端形式婚惫,建議使用客戶端的方式安裝
?
Postman下載
官網(wǎng)下載地址:https://www.getpostman.com/downloads/安裝過程
默認(rèn)安裝即可氛赐,安裝完成后,建議注冊賬號便于以后將腳本保存到云端
三先舷、Postman功能視圖
詳細(xì)功能可以參考Postman官方 文檔,
打開軟件艰管,就可以看到Postman主界面,如下圖所示:
Collections:在Postman中蒋川,Collection類似文件夾牲芋,可以把同一個項目的請求放在一個Collection里方便管理和分享,Collection里面也可以再建文件夾捺球。如果做API文檔的話缸浦,可以每個API對應(yīng)一條請求,如果要把各種輸入都測到的話懒构,就需要每條測試一條請求了餐济。這里我新建了一個example用于介紹整個流程,五個API對應(yīng)五條請求胆剧。這個Collection可以通過https://www.getpostman.com/collections/c8f98a1120357e0d4a5a 導(dǎo)入你自己的Postman中絮姆。
上面的黑字注冊是請求的名字醉冤,如果有Request description的話會顯示在這下面。下面的藍(lán)字是保存起來的請求結(jié)果篙悯,點擊可以載入某次請求的參數(shù)和返回值蚁阳。我會用這個功能給做客戶端的同事展示不同情況下的各種返回值。保存請求的按鈕在15.
選擇HTTP Method的地方鸽照,各種常見的不常見的非常全螺捐。
請求URL,兩層大括號表示這是一個環(huán)境變量矮燎,可以在16的位置選擇當(dāng)前的environment定血,環(huán)境變量就會被替換成該environment里variable的值。
點擊可以設(shè)置URL參數(shù)的key和value
點擊發(fā)送請求
點擊保存請求到Collection诞外,如果要另存為的話澜沟,可以點擊右邊的下箭頭
設(shè)置鑒權(quán)參數(shù),可以用OAuth之類的
自定義HTTP Header峡谊,有些因為Chrome愿意不能自定義的需要另外裝一個插件Interceptor茫虽,在16上面一行的衛(wèi)星那里
設(shè)置Request body,13那里顯示的就是body的內(nèi)容
在發(fā)起請求之前執(zhí)行的腳本既们,例如request body里的那兩個random變量濒析,就是每次請求之前臨時生成的。
在收到response之后執(zhí)行的測試啥纸,測試的結(jié)果會顯示在17的位置
有四種形式可以選擇号杏,form-data主要用于上傳文件。x-www-form-urlencoded是表單常用的格式脾拆。raw可以用來上傳JSON數(shù)據(jù)
返回數(shù)據(jù)的格式馒索,Pretty可以看到格式化后的JSON莹妒,Raw就是未經(jīng)處理的數(shù)據(jù)名船,Preview可以預(yù)覽HTML頁面
點擊這里把請求保存到2的位置
設(shè)置environment variables和global variables,點擊右邊的x可以快速查看當(dāng)前的變量旨怠。
測試執(zhí)行的結(jié)果渠驼,一共幾個測試,通過幾個鉴腻。
四迷扇、測試工具
測試工具主要包括三部分,在發(fā)起請求之前運行的Pre-request爽哎,在收到應(yīng)答之后運行的Test蜓席,和一次運行所有請求的Collection Runner
-
Pre-request
預(yù)請求腳本是與在發(fā)送請求之前執(zhí)行的收集請求相關(guān)聯(lián)的代碼片段。
pre.png
Pre-request和Test用的語言都是JavaScript课锌,Postman在一個沙盒里執(zhí)行代碼厨内,提供給用戶的庫和函數(shù)可以在這里查看祈秕。而常用的功能都可以通過右邊的Code Snippets實現(xiàn),點擊就可以插入到代碼區(qū)域雏胃。
-
Test
使用Postman请毛,您可以使用JavaScript語言為每個請求編寫和運行測試.
test.png
?
測試?yán)?/em>
設(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標(biāo)簽中name屬性值為SignValue的數(shù)據(jù)中屬性為value的值
var signvalue=$('input[name=SignValue]').attr('value');
//
//獲取textarea標(biāo)簽中name值為SignValue的數(shù)據(jù)中文本屬性text的值
var signvalue=$('textarea[name=SignValue]').text();
?
-
Collection Runner
當(dāng)編寫了很多測試之后瞭亮,就可以使用Collection Runner來自動運行整個Collection了方仿,入口就在主界面最上面一行的Runner。選好Collection统翩、Environment仙蚜,如果有需要還可以載入JSON和CSV作為數(shù)據(jù)源。點擊Start Run厂汗,就可以看到結(jié)果了鳍征。
Coo.png
五、變化的參數(shù)
- 使用變量
現(xiàn)在使用參數(shù)都是寫死的面徽, 那么如果想要測試賬號密碼參數(shù)使用其它值有沒有異常怎么辦呢艳丛?
這里就需要使用變量
引用變量的語法:{{變量名}}
Pre-request Script 和 Tests都可以設(shè)置變量,區(qū)別在于:Pre-request Script 中的腳本是在執(zhí)行請求之前運行趟紊,而Tests 中的腳本則是在請求完成之后執(zhí)行氮双。 -
測試數(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文件格式:
在執(zhí)行Collection Runner時使用CSV/JSON文件
-
定期任務(wù)
Postman 提供了一個 Monitors (監(jiān)視器)功能,支持我們提交一個測試任務(wù)霎匈,按照設(shè)置的定時器進(jìn)行運行戴差,如每小時測試一次,具體操作如下:
mo.png
hour.png
?
六铛嘱、接口依賴的問題
- 接口執(zhí)行順序
首先暖释,說明一下,接下來說的接口都是默認(rèn)屬于同一個集合 (Collections) 中的墨吓。
接口的執(zhí)行順序其實就是按照這邊目錄中的順序(從上到下)球匕;所以有了這個默認(rèn)的執(zhí)行順序后,那么我們便可以把需要優(yōu)先執(zhí)行的接口放前面即可帖烘,比如把“登錄接口”放在第一個亮曹。 -
自定義執(zhí)行順序
當(dāng)然,如果只有默認(rèn)的一個執(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ù)按默認(rèn)順序執(zhí)行氏义,即圖中的接口 Request4 仍會被執(zhí)行。
- 指定的跳轉(zhuǎn)接口必須屬于同一個集合中图云。
- setNextRequest() 函數(shù)不管在 Tests 腳本中何處被調(diào)用惯悠,它都只在當(dāng)前腳本最后才被真正執(zhí)行。比如我們將圖中的第二行與第一行互調(diào)后竣况,那么在運行跳轉(zhuǎn)函數(shù)后第二行代碼仍會被執(zhí)行克婶。
- 解決依賴的思路
- 保證 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