Apidog 支援資料驅動測試,讓你可以匯入 CSV 或 JSON 格式的測試資料集,並在測試請求中使用它們。開始使用#
2
準備測試資料。一組測試資料是一個二維表格,其中每一欄代表一個變數,每一列包含這些欄位的一組值,用於單次測試場景迭代。例如,你可以準備一個包含以下資料的 CSV 檔案。
| 資料集名稱 | petType | petName | age | price |
|---|
| Pet-1 | Dog | Buddy | 3 | 300 |
| Pet-2 | Cat | Whiskers | 2 | 150 |
| Pet-3 | Bird | Tweety | 1 | 50 |
| Pet-4 | Rabbit | Thumper | 4 | 80 |
| Pet-5 | Dog | Max | 5 | 250 |
3
切換到「Test Data」分頁,點擊「New」以新增一組測試資料。
5
將測試資料變數新增到你的請求中。測試資料變數的名稱應與二維表格中的欄位名稱一致。
測試資料#
每個測試場景都可以維護多組測試資料,並且你可以在執行場景時選擇要使用哪個資料集。測試資料可以依環境進行設定,因此當你切換到不同環境時,將使用對應的測試資料集。例如,你可以為測試環境和開發環境維護一組寵物資料,並使用相同的變數名稱。當你切換環境時,將使用對應環境中的變數值。編輯測試資料#
你可以匯入/匯出 CSV 或 JSON 格式的測試資料,也可以手動新增和編輯測試資料。使用測試資料#
你可以使用 {{variable}} 將測試資料變數插入到請求參數、標頭、主體及其他位置。執行測試場景時,這些變數將被替換為對應的測試資料值。變數名稱可能與其他變數相同。當存在重複的變數名稱時,優先順序為:本機變數 > 測試資料變數 > 環境變數 > 全域變數。在指令碼中使用測試資料#
pm.iterationData.has(variableName:String): function → Boolean: 檢查測試變數是否存在。
pm.iterationData.get(variableName:String): function → *: 取得測試變數 。
pm.iterationData.replaceIn(variableName:String): function: 將字串中的動態變數替換為其實際值。
pm.iterationData.toObject(): function → Object: 以物件形式取得所有本機變數。常見問題#
A: 在 Windows 上,Excel 預設會自動使用 GBK 編碼儲存 CSV 檔案。這可能導致在其他軟體中檢視 CSV 時出現亂碼。此外,舊版 Excel(例如 Excel 2016)在將 CSV 儲存為 UTF-8 時通常不會儲存 BOM(位元組順序標記),這也可能導致亂碼。在 Windows 上,將 CSV 重新儲存為 UTF-8 編碼。
在 macOS 上,執行 iconv -f GBK -t UTF-8 xxx.csv > utf-8.csv 以轉換編碼。
Modified at 2026-06-11 10:26:02