Che cos'è il formato di file TRX?
Un file .trx è un file di risultati dei test basato su XML generato dall'infrastruttura di test di Microsoft Visual Studio. Il formato è stato introdotto con Visual Studio .NET 2003 e il framework MSTest, e rimane il formato di output predefinito sia per mstest.exe che per il runner multipiattaforma dotnet test.
Il file è un documento XML in formato UTF-8 semplice il cui elemento radice è <TestRun> all'interno di un namespace XML specifico di Microsoft. Al suo interno, registra <TestSettings> (configurazione dell'esecuzione), <TestDefinitions> (nomi dei metodi di test e assembly), <Results> con un <UnitTestResult> per ogni caso di test (esito, durata, timestamp, messaggi di errore, stack trace) e un <ResultSummary> con i conteggi aggregati di Superati/Falliti/Inconcludenti. Lo schema è definito in vstst.xsd, fornito con Visual Studio nella directory Common7/IDE/.
I file .trx non vengono creati automaticamente: richiedono una configurazione esplicita del logger. Per generarne uno, passa --logger trx a dotnet test, oppure fornisci il flag equivalente a mstest.exe. Azure DevOps e TFS analizzano i file .trx nativamente tramite l'attività Publish Test Results, visualizzando i report di superamento/fallimento nell'interfaccia utente della pipeline.
Poiché .trx è un formato XML, qualsiasi editor di testo può aprirlo. Visual Studio Code con il C# Dev Kit offre una visualizzazione più ricca. Il formato è incentrato su Microsoft; i sistemi CI multipiattaforma come GitHub Actions o Jenkins preferiscono tipicamente i report di test JUnit XML. A partire da Visual Studio 2022 e dal .NET SDK, la generazione di .trx è supportata anche su Linux e macOS tramite dotnet test.
Sicurezza e incolumità
RISCHIO: LOWI file TRX sono XML UTF-8 semplici: contengono risultati di test, non codice eseguibile. Aprirli in Visual Studio, VS Code o in un editor di testo è completamente sicuro. Non utilizzare download di «visualizzatori TRX» di terze parti di origine sconosciuta; non sono necessari e potrebbero contenere adware. Visual Studio Community (gratuito) o VS Code (gratuito, open source) sono strumenti di apertura sicuri e sufficienti.
Dettagli del formato
in sintesiProgrammi che aprono file TRX
Dettagli tecnici
specifiche approfondite| Tipo di file | Documento XML UTF-8 (testo semplice) |
| Elemento radice XML | `<TestRun>` nel namespace XML Microsoft vstst |
| File di schema | `vstst.xsd` - fornito con Visual Studio in `Common7/IDE/` |
| Comando generatore | `dotnet test --logger trx` o `mstest.exe /logger:trx` |
| Dimensione tipica del file | 5 KB - 10 MB (varia in base al numero di test e alla verbosità dello stack trace) |
| Elemento record per test | `<UnitTestResult>` - memorizza esito, durata, timestamp, messaggio di errore e stack trace |
| Elemento di riepilogo | `<ResultSummary>` - conteggi aggregati di Superati, Falliti, Inconcludenti e Totali |
| Contenitore risultati | Elemento `<Results>` che contiene tutti i figli `<UnitTestResult>` |
| Non generato per impostazione predefinita | Richiede il flag esplicito `--logger trx`; non viene creato con una normale esecuzione di `dotnet test` |
| Supporto piattaforma | Windows, Linux, macOS (tramite .NET SDK multipiattaforma) |
| Integrazione Azure DevOps | Analizzato nativamente dall'attività della pipeline Publish Test Results |
| Formato CI multipiattaforma | JUnit XML preferito dai sistemi CI non Microsoft (GitHub Actions, Jenkins, GitLab CI) |
| Variazione del formato generatore | Il TRX di `mstest.exe` differisce leggermente dal TRX prodotto da `dotnet test`; entrambi sono validi |
| Compressione | Nessuna - XML semplice; suite di test di grandi dimensioni con stack trace possono produrre file di diversi MB |
| Rilasciato | 2003 (Visual Studio .NET 2003, MSTest framework) |
| Ultima versione | vstst.xsd schema current as of Visual Studio 2022; vstest also generates TRX in .NET SDK 2026 |
| Specifica | learn.microsoft.com |
Conversioni TRX
Domande e risposte della community
chiesto dagli utentiAncora nessuna domanda - sii il primo a chiedere informazioni sui file TRX.