測試報告擴充功能

本文列出並說明與測試報表功能相關的所有 Microsoft.Testing.Platform 延伸模組。

測試報告是一個檔案，其中包含測試的執行和結果相關信息。

Visual Studio 測試報告

Visual Studio 測試結果檔案 （或 TRX） 是發佈測試結果的預設格式。 此延伸模組隨附於 Microsoft.Testing.Extensions.TrxReport 套件中。

可用的選項如下所示：

選擇	描述
--report-trx	產生 TRX 報表。
--report-trx-filename	產生的 TRX 報表名稱。 預設名稱符合下列格式 <UserName>_<MachineName>_<yyyy-MM-dd HH:mm:ss>.trx。

報表會儲存在可透過 命令行自變數指定的預設 --results-directory 資料夾中。

Azure DevOps 報表

Azure DevOps 報告外掛增強了程式碼託管在 GitHub 上但在 Azure DevOps 建置代理程式上建置的開發者的測試執行。 它會在失敗時加入額外資訊，直接在 GitHub PR 中顯示失敗。

該擴充套件隨 Microsoft.Testing.Extensions.AzureDevOpsReport 套件一同推出。

可用的選項如下所示：

選擇	描述
--report-azdo	在 CI 建置中啟用輸出錯誤/警告。
--report-azdo-severity	用來標示報告事件的嚴重程度。 選項有： error （預設）和 warning。

擴充功能會自動偵測其是否在持續整合（CI）環境中運行，方法是檢查 TF_BUILD 環境變數。

決定報告內容

為了標示錯誤程式碼中失敗發生的行，AzureDevOps 報告外掛會在錯誤堆疊追蹤中搜尋目前儲存庫中存在的檔案。

為了確定這個問題，它：

• 尋找儲存庫根，這是透過搜尋 .git 最接近測試應用程式起始位置的目錄來完成的（由 AppContext.BaseDirectory確定）。
• 尋找堆疊跟踪中第一行包含檔案位置和行數的行（函式庫需要包含除錯符號）。
• 排除所有以 結尾的 Assert.cs 檔案，以避免顯示你的斷言實作或包裝器的細節。
• 排除所有磁碟上不存在的檔案（通常是來自外部函式庫的除錯符號行，例如 MSTest）。

（這些是內部細節，用來協助除錯行為，未來可能會有所改變。）