TRX ファイル形式とは?
.trx ファイルは、Microsoft Visual Studio のテストインフラストラクチャによって生成される XML ベースのテスト結果ファイルです。この形式は Visual Studio .NET 2003 と MSTest フレームワークで導入され、現在も mstest.exe およびクロスプラットフォームの dotnet test ランナーの両方でデフォルトの出力形式として使用されています。
このファイルはプレーンな UTF-8 XML ドキュメントであり、ルート要素は Microsoft 固有の XML 名前空間内の <TestRun> です。内部には、<TestSettings>(実行構成)、<TestDefinitions>(テストメソッド名とアセンブリ)、テストケースごとの <Results>(結果、期間、タイムスタンプ、エラーメッセージ、スタックトレースを含む <UnitTestResult>)、および成功/失敗/不確定の合計カウントを含む <ResultSummary> が記録されます。スキーマは vstst.xsd で定義されており、Visual Studio の Common7/IDE/ ディレクトリに同梱されています。
.trx ファイルは自動的には作成されません。明示的なロガー設定が必要です。生成するには、dotnet test に --logger trx を渡すか、mstest.exe に同等のフラグを指定します。Azure DevOps および TFS は、「テスト結果の公開(Publish Test Results)」タスクを通じて .trx ファイルをネイティブに解析し、パイプライン UI にパス/失敗レポートを表示します。
.trx は XML 形式であるため、任意のテキストエディタで開くことができます。C# Dev Kit をインストールした Visual Studio Code を使用すると、より高度な視覚化が可能です。この形式は Microsoft 中心です。GitHub Actions や Jenkins などのクロスプラットフォーム CI システムでは、通常 JUnit XML テストレポートが好まれます。Visual Studio 2022 および .NET SDK 以降、.trx の生成は dotnet test を介して Linux および macOS でもサポートされています。
セキュリティと安全性
リスク: LOWTRX ファイルはプレーンな UTF-8 XML であり、実行コードではなくテスト結果が含まれています。Visual Studio、VS Code、またはテキストエディタで開くことは完全に安全です。出所不明のサードパーティ製「TRX ビューア」をダウンロードしないでください。これらは不要であり、アドウェアが含まれている可能性があります。Visual Studio Community(無料)または VS Code(無料、オープンソース)で十分に安全に開くことができます。
形式の詳細
概要TRX ファイルを開くプログラム
技術的詳細
詳細仕様| ファイル形式 | UTF-8 XML ドキュメント(プレーンテキスト) |
| ルート XML 要素 | Microsoft vstst XML 名前空間内の `<TestRun>` |
| スキーマファイル | `vstst.xsd` - Visual Studio の `Common7/IDE/` に同梱 |
| 生成コマンド | `dotnet test --logger trx` または `mstest.exe /logger:trx` |
| 一般的なファイルサイズ | 5 KB - 10 MB(テスト数とスタックトレースの冗長性に比例) |
| テストごとの記録要素 | `<UnitTestResult>` - 結果、期間、タイムスタンプ、エラーメッセージ、スタックトレースを格納 |
| サマリー要素 | `<ResultSummary>` - 成功、失敗、不確定、および合計のカウントを集計 |
| 結果コンテナ | すべての `<UnitTestResult>` 子要素を保持する `<Results>` 要素 |
| デフォルトでは生成されない | 明示的な `--logger trx` フラグが必要。通常の `dotnet test` 実行では作成されません |
| プラットフォームサポート | Windows, Linux, macOS(クロスプラットフォーム .NET SDK 経由) |
| Azure DevOps 統合 | 「テスト結果の公開」パイプラインタスクによってネイティブに解析 |
| クロスプラットフォーム CI 形式 | Microsoft 以外の CI システム(GitHub Actions, Jenkins, GitLab CI)では JUnit XML が推奨される |
| 生成形式のバリエーション | `mstest.exe` からの TRX は `dotnet test` で生成される TRX とわずかに異なりますが、どちらも有効です |
| 圧縮 | なし - プレーンな XML。スタックトレースを含む大規模なテストスイートでは数 MB のファイルになることがあります |
| リリース日 | 2003 (Visual Studio .NET 2003, MSTest framework) |
| 最新バージョン | vstst.xsd schema current as of Visual Studio 2022; vstest also generates TRX in .NET SDK 2026 |
| 仕様書 | learn.microsoft.com |
TRX の変換
コミュニティ Q&A
ユーザーからの質問まだ質問はありません。TRX ファイルについて最初の質問をしてみましょう。