選擇合適的執行方式#
Apidog 提供多種執行測試場景的方式，適用於不同的測試需求。此方式由本機啟動，適合小規模、快速測試。當開發與測試同時進行時特別有效，可即時監控並立即調整。此方式非常適合處理大規模資料或反覆迭代的場景，並提供更快的執行速度。它可以離線執行，適用於資源受限或不需要圖形使用者介面的環境。此執行方式整合於 CI/CD 管線中，是自動化整合與持續部署流程的理想選擇。對於需要在每次程式碼更新後頻繁執行測試，以確認 API 穩定性的場景尤其有用。團隊可以在自己的伺服器上設定 Apidog Runner，利用更強大的運算資源進行測試。此方式支援排程任務，非常適合需要定期測試或測試需求較大的場景。在測試場景中，如果使用了環境/全域變數，這些變數的實際值可能會依所選的執行方式而不同，進而導致測試結果不一致。了解更多。 開始使用#
1
前往所需的測試場景，並選擇你希望請求執行所在的環境。
3
你會看到一份測試報告，其中顯示目前執行的通過率、執行時間及其他資料。你可以展開每個請求以查看驗證與斷言。
測試場景中的執行選項#
在 Apidog 中執行測試場景時，可以設定多個設定與選項，以便依特定需求自訂測試執行。指定場景中的請求應導向的服務（base URL），以及要使用的變數集。更多詳細資訊請參閱環境與服務。請注意，自訂請求具有自己的完整 URL，與匯入的步驟不同，將不會導向此處設定的環境。測試資料#
測試場景支援匯入外部測試資料集。當測試場景執行時，系統會循環遍歷資料檔案中的所有資料集，並將資料集中的資料指派給對應的變數，詳細資訊請參閱資料驅動測試。迭代次數#
如果需要處理大量資料，建議使用 Apidog CLI 執行，而 非 Apidog 用戶端，以最佳化效能。執行緒#
以多個執行緒執行所有步驟，且執行緒之間的資料保持隔離，以避免互相干擾。請注意，此功能仍處於 Beta 階段，可能需要進一步的效能最佳化。若要進行嚴格的負載測試，建議改用效能測試功能。
CLI 不支援執行緒。執行於#
實際消耗硬體資源來執行測試場景的機器。測試場景中發起的所有請求都會從此處指定的機器送出。因此，發起請求的機器所處網路環境不同，可能會導致測試結果有所差異。此設定不會儲存為測試場景執行設定的一部分。每次預設都會使用本機來執行測試場景。此外，此設定在批次執行或 CLI 執行期間不會生效。在這些情況下，請求會使用目前機器的資源發起。
Advanced Settings 右側的「Share」選項，每次測試場景執行後產生的測試報告都會自動與專案中的其他成員共享。你可以在 Test Reports 區段的 Shared 分頁下查看團隊內已共享的所有測試報告。更多詳細資訊請參閱測試報告。進階設定#
發生錯誤時#
設定測試應如何處理錯誤，其中可能包括斷言失敗、資料格式驗證失敗、伺服器錯誤等。選項如下：在傳送每個步驟之間設定暫停時間，以管理並控制執行速度。儲存請求/回應#
預設情況下，Apidog 會儲存每個請求與回應。當請求或回應非常大（可能達數 MB）時，可能會佔用大量磁碟空間。你可以啟用此選項，不儲存每個請求與回應，而只儲存斷言與驗證結果。或者，你也可以選擇僅儲存失敗的請求與回應，以節省空間。保留變數值#
此選項預設啟用，確保在測試期間修改 global 與 environment 變數時，其目前值會保留最後一次修改後的結果。如果停用此選項，全域與環境變數在測試執行後不會變更；它們會保留執行前的值。使用已儲存的 cookies 執行#
在 Apidog 右下角， Cookies 圖示可前往 cookie 管理。Apidog 會在發出 API 請求時自動儲存 cookies。如果你想在測試場景執行期間使用已儲存的 cookies，請啟用此選項。執行後儲存 cookies#
與上述類似，如果你希望在執行測試場景後更新已儲存的 cookies，請啟用此選項。透過在 Apidog 中設定這些進階設定，你可以微調測試執行，以符合你的特定測試需求，確保測試執行高效且精準。測試場景設計模式下的執行時設定#
如果你處於測試場景設計模式，相關的執行時設定會收合在「Run」按鈕右側。將滑鼠停留在此設定按鈕上，即可查看此測試場景的詳細執行時設定。執行功能測試#
執行功能測試後，你會被導向測試場景執行頁面。下圖中的圓餅圖提供測試結果概覽，並會在測試場景執行時即時更新。圓餅圖下方會顯示正在執行的詳細測試步驟，並在執行期間顯示每個步驟的狀態。功能測試執行完成後，你可以點擊相關端點，以查看其在測試期間的指標與狀態。這包括端點名稱、請求方法、請求 URL、回應狀態碼、回應時間、回應內容、資料驗證與斷言結果。更多詳細資訊請參閱測試報告。在不同執行方式中使用環境/全域變數的規則#
環境與全域變數具有持久性，表示它們可以保存以供長期使用，並可跨多次執行或不同測試場景使用。然而，實際使用的變數值可能會依所 選執行方式而不同。例如：如果測試場景使用環境變數 Token，它在用戶端中執行時可能成功，但使用自託管 Runner 執行時可能失敗，因為 Token 的值不正確。造成此差異的原因可能是：執行時環境變數 Token 的實際值取自用戶端中本機儲存的值。然而，使用自託管 Runner 執行時，Runner 並沒有相同的本機儲存 Token，因此導致失敗。為了解決此問題，Apidog 提供了一組規則，用於管理不同執行方式中的環境/全域變數值：| 執行方式 | 環境/全域變數使用方式 | 變數儲存位置 |
|---|
| 本機（用戶端、Web） | 使用環境/全域變數的目前值進行執行。 | 儲存在本機。可以手動修改，或透過前置/後置處理器更新。可在 Environment Management > Environment/Global Variables > Current Values 中查看。 |
| CLI、CI/CD | 對於即時線上執行：- 使用環境/全域變數的初始值進行執行 （預設）。
- 透過
--variables path 選項，指定使用儲存在執行測試場景機器上檔案中的環境/全域變數值。了解更多。
- 使用匯出檔案中包含的環境/全域變數值進行執行。
| - 初始值儲存在 Apidog Cloud 中，且只能在用戶端內手動修改。
- 儲存在
--variables path 選項指定的檔案中，可手動修改，或透過前置/後置處理器更新。 - 儲存在匯出的檔案中。可手動修改，或透過前置/後置處理器更新。
|
| 自託管 Runner | - 使用環境/全域變數的初始值進行執行 （預設）。
- 使用 Runner 內本機儲存的值進行執行。 了解更多。
| - 初始值儲存在 Apidog Cloud 中，且只能在用戶端內手動修改。
- 儲存在指定的 Runner 中。可手動修改，或透過前置/後置處理器更新。可透過產品使用者介面查看，或在 Runner 內的檔案
/opt/runner/variables 中查看。
|
執行包含來自其他專案端點的測試場景#
當測試場景包含從其他專案匯入的端點時，執行期間這些端點的請求 URL 會由你在 Environment associations 中設定的配置決定。如果目前專案的「Develop Env」與另一個專案的「Prod Env」建立關聯，當使用「Develop Env」執行測試場景時，匯入的端點會被送往「Prod Env」中的 URL。所有其他端點則會使用目前專案「Develop Env」中的 URL。實作各種測試#
上述步驟代表測試場景的基本執行方式。設定測試場景時，你可以加入各種進階設定，以滿足多樣化的測試需求。資料驅動測試： 使用多樣化資料集進行測試，以驗證系統在各種場景中的行為。 效能測試： 在不同負載條件下評估系統效能，以評估可擴充性與回應能力。 排程任務： 建立結構化計畫，詳細說明測試活動的範圍、方法與時程。 
