自動化測試｜Eolink Apikit 如何儲存、使用測試用例

測試用例是測試過程中很重要的一類文件，它是測試工作的核心，是一組在測試時輸入和輸出的標準，是軟體需求的具體對照。

測試用例可以幫助測試人員理清測試思路，確保測試覆蓋率，發現需求漏洞，提高軟體質量，提高測試效率，降低測試成本。

Eolink Apikit 的API 管理應用中，測試用例管理涉及到兩個場景： 單介面測試用例管理 和 多介面測試用例批次測試。

單介面測試用例管理

功能入口： API管理應用 - 選中某個專案 - API文件選單 - 選中某一API文件 - 點選 測試用例TAB

該功能用於對已建立的API介面文件進行介面測試用例的管理。可在該API文件中建立多個測試用例，以用於驗證該介面的多個不同的資料輸入場景下，介面返回是否符合期望。

1. 新增測試用例

點選單API文件的測試用例列表頁中的 新增測試用例按鈕即會彈出 新增測試用例彈窗。

測試用例一共分三個部分：基礎資訊、請求引數和斷言規則。

基礎資訊

基礎資訊包含了優先順序、用例名稱、API介面地址和說明等資訊。

• 優先順序：測試用例優先順序，用於區分當前測試用例的重要程度，以便於進行篩選和透過openapi觸發特殊的流程業務。

• 用例名稱：測試用例的名稱，一般會輸入該用例對應場景名稱。

• API介面地址：可調整介面的協議、請求方式、和URL地址。但一般不建議變動協議和請求方式。

• 說明：用於說明該測試用例的純文字內容，非必填。

請求引數

新增單API文件的測試用例時，系統會自動把API文件的請求引數同步到測試用例的請求引數區域。使用者基於預匯入的資料進行編輯即可。

測試用例的請求引數編輯和測試API文件中一樣，沒有任何區別，請查閱對應的使用說明測試API文件

斷言規則

斷言是用於判斷介面返回結果在某個位置上是否能滿足預期的檢驗方法。Eolink Apikit 支援四種斷言規則設定方法：HTTP狀態碼、響應頭部、響應體、響應時間。

• HTTP狀態碼

  可勾選是否校驗HTTP狀態碼，預設勾選，並預設校驗狀態碼為200。

  使用者可配置多個狀態碼，使用英文逗號 ,隔開。配置多個狀態碼時，只要返回結果狀態碼命中任意一個已配置的狀態碼，即校驗透過。否則觸發斷言規則，中止測試，並返回斷言失敗資訊。

• 響應頭部

  可選是否校驗響應頭部，預設不勾選，不校驗。新增測試用例時會自動同步API文件中的返回頭部內容。

  響應頭部引數校驗時，預設不校驗引數值內容。僅校驗斷言規則中勾選必含的引數是否在測試的返回頭部中有存在。

  若需要校驗引數值內容，則需要在對應的引數行的內容校驗選項中，選擇是校驗該引數等於或不等於某個值。例如配置了某引數等於A，若請求返回的引數值為A，則透過校驗，否則斷言失敗，中止測試。

• 響應體

  響應體即返回結果，可選是否校驗返回結果，預設勾選校驗。斷言規則的響應體內容是自動同步API文件中的返回結果內容。若該API文件有多個返回結果，則同步的是預設返回結果內容（即第一個返回結果）

  響應體引數校驗規則和響應頭部一樣。可選僅校驗引數是否包含在返回結果內，或進一步校驗該引數等於或不等於某個值。

• 響應時間

  是對介面請求響應時間的斷言校驗，可選是否校驗響應時間，預設勾選校驗並預設跟隨專案全域性設定時間。專案的全域性響應時間校驗規則配置在專案管理選單中操作。

  若超時設定選擇自定義，則可以對當前測試用例設定獨立的計時依據和時間限制。

  計時依據有請求總時間和首位元組返回時間兩種選擇。請求總時間即從觸發測試開始計算到最後全部返回資訊到達的完整總時長，也是最常見的計算方式；首位元組返回時間即從觸發測試開始計算到接收到位元組返回的時間結束的總時長。其中，若選擇瀏覽器測試時，因瀏覽器的限制，僅能根據請求總時間進行斷言校驗。

  時間限制設定即為設定響應時間的校驗邊界值，響應時間在多少毫秒內算校驗透過。對於SaaS使用者，若使用線上測試，則該邊界值最高只能是3600000ms，即1個小時。若使用私有云版本，則無上限。同理，在自動化測試中，執行定時任務時，介面請求的響應時間最大為1個小時，若超時則會中止測試。

2. 執行測試用例

單測試用例測試

在測試用例列表右側，可點選 測試按鈕，對測試用例執行測試。

點選後會彈出右抽屜彈窗，展示本次的測試報告，並可透過點選左側一列檢視當前介面文件所有測試用例的 測試歷史。

批次測試用例測試

在測試用例列表中，每行測試用例資料前均有一個勾選框，系統預設均勾選。用可以勾選 需要批次測試的測試用例，並點選列表頂部的 批次測試按鈕，進行批次測試用例測試。

點選後會彈出右抽屜彈窗，展示本次批次操作的測試報告。

3. 匯出與匯入測試用例

對單介面下的測試用例匯出，需要先在測試用例列表頂部選擇 批次操作。然後勾選需要匯出的測試用例後，再點選頂部的 匯出按鈕即可。系統會自動生成符合 Eolink 資料格式的json檔案。

在需要匯入的API文件測試用例列表頁，可點選 新增用例旁的下拉按鈕，在下拉選擇框中選擇 匯入測試用例操作，然後選擇 eolink 格式的測試用例json檔案即可匯入。

多介面測試用例批次測試

功能入口： API管理應用 - 選中某個專案 - API測試用例選單

API測試用例頁（批次測試頁）中佈局和API列表頁相似，左側是分組欄，右側是API資訊列表。但不一樣的是該頁面無新增按鈕，分組和API資訊均繼承於API選單頁中建立的分組和API文件。

1. 測試控制檯

使用者勾選API測試用例頁中每行API資訊前的勾選框後，代表選中該介面下的用例進行批次測試。頁面下方的測試控制檯自下往上的彈出。

測試工具

在測試控制檯的首行，是各種測試工具：

• 測試按鈕

  首行左側第一個按鈕是測試按鈕，預設是伺服器端發起測試。使用者可透過按鈕右側的下拉選擇按鈕，選擇透過瀏覽器外掛發起測試。

  點選測試按鈕後，會對測試控制檯中已選中的所有測試用例進行序列測試。

• 清空列表

  點選後可快速清空測試控制檯中的所有API列表內容。

• 下載報告

  該按鈕預設不可點選，當使用者執行測試，並測試任務完成後，該按鈕方可點選。點選按鈕後可下載本次批次測試的測試報告。

• 環境管理工具

  該環境管理工具與測試API文件中所描述的互動一致，詳細能力可跳轉檢視。測試API文件

• 測試結果統計

  可檢視所選中的測試用例的當前測試結果狀態統計，分別有未測試、測試成功、測試未透過三種狀態。注意，僅統計選中的測試用例。

2. 測試用例執行列表

測試控制檯中，測試用例執行列表按介面進行分組。API介面資訊用黃色背景區分。

在API列表中選擇了某個API介面後，測試控制檯會自動新增該API介面名稱，並在名稱下展示該介面的所有測試用例資訊，且預設勾選 所有測試用例。使用者也可以點選介面名稱旁的 移除按鈕，把當前的介面及其測試用例資訊移除於測試用例執行列表外。

若該API文件未新增任何測試用例，則可以點選介面名稱旁的 快速新增用例按鈕，快速建立測試用例並選中。