如何在測試步驟之間傳遞資料？

在自動化測試情境中，在多個請求之間傳遞資料非常常見。典型案例包括：

請求 1 是登入請求，會回傳 token；請求 2 使用此 token 來請求其他資料。

請求 1 回傳一個 ID；請求 2 根據此 ID 執行操作。

請求 1 回傳一個清單；請求 2 使用此清單中的資料。

針對這類情境，Apidog 提供兩種不同的解決方案，用於處理請求之間的資料傳遞。你可以根據手邊的具體問題選擇合適的解決方案。

擷取前置步驟資料：此功能可讓你在後續請求中直接使用前面請求的資料。

優點是簡單，不需要引入額外變數。

不過，當資料需要被多次引用時，可能會稍微繁瑣。

擷取前置步驟資料功能「只能」在「Tests」模組中使用，不能在「APIs」模組中使用。

使用變數：在前一個請求的前置處理器中新增「Extract Variables」，將所需資料儲存在變數中，然後在後續請求中呼叫此變數。

優點是在多次引用資料時很方便，但對於單次引用而言可能稍微複雜。

變數可同時在「Tests」模組和「APIs」模組中使用。

擷取前置步驟資料

我們來考慮一個情境：請求 1 是登入請求，會回傳 token，而請求 2 使用此 token 來請求額外資料。

將登入請求（請求 1）新增到測試情境中。

將查詢請求（請求 2）新增到測試情境中。

請求 2 的查詢參數需要包含請求 1 回傳的 token。點擊請求 2 查詢參數中 token 欄位的「魔法棒」圖示 🪄，並選擇「擷取前置步驟資料」。

選擇請求 1 進行資料擷取，選擇回應主體，並使用 JSONPath 擷取請求 1 回傳的 token，例如 $.token。

點擊插入，你會看到 {{$.2.response.body.token}} 被插入為查詢參數。

點擊測試情境中的「Run」按鈕，即可成功將資料從請求 1 傳遞到請求 2。

「擷取前置步驟資料」功能「僅」可在「Tests」模組中使用，不能在「APIs」模組中使用。

使用「擷取前置步驟資料」時，只有在整個測試情境一起執行時才能取得值；執行單一步驟時無法存取。

以前文中的 {{$.2.response.body.token}} 為例：

'2' 代表步驟 ID，可在每個測試步驟中找到。

'response.body' 表示前置步驟資料的位置。這可以包含請求的標頭、主體，或回應的標頭或主體等資料。具體內容請見下方。

'token' 代表主體中下一層的 'token' 資料。你可以使用 JSONPath 語法擷取所需資料。

前置步驟資料可用於請求的各個部分，例如請求參數、標頭、驗證等。你也可以將資料直接插入請求主體，如下所示。

需要注意的是，如果你需要在腳本中使用前置步驟資料，不能直接使用 {{variable}} 語法引用變數。相反地，你應使用 pm.variables.get 來引用前置步驟資料。例如：

類別	功能	語法範例
請求	URL	{{$.<step id>.request.url}}
	路徑參數	{{$.<step id>.request.pathParam.<field name>}}
	查詢	{{$.<step id>.request.query.<field name>}}
	標頭	{{$.<step id>.request.header.<field name>}}
	主體（form）	{{$.<step id>.request.body.<field name>}}
	主體（json）	{{$.<step id>.request.body.<field path>}}
回應	主體	{{$.<step id>.response.body.<field path>}}
	標頭	{{$.<step id>.response.header.<field name>}}
	Cookie	{{$.<step id>.response.cookie.<field name>}}
迴圈	元素（ForEach 迴圈中的陣列元素）	{{$.<loop step id>.element.<field path>}}
迴圈	索引	{{$.<loop step id>.index}}

我們來考慮一個情境：請求 1 是登入請求，會回傳 token，而請求 2 使用此 token 來請求額外資料。

將登入請求（請求 1）新增到測試情境中。

在請求 1 的後置處理器中，新增一個「Extract Variable」動作，將 $.token 擷取為 {{token}}。

了解更多關於 Extract variable 的資訊。

將查詢請求（請求 2）新增到測試情境中。

在請求 2 的查詢參數中引用變數 {{token}}。

點擊測試情境中的「Run」按鈕，即可成功將資料從請求 1 傳遞到請求 2。