Estensioni dei report di test

Questo articolo elenca e illustra tutte le estensioni Microsoft.Testing.Platform correlate alla funzionalità del report di test.

Un report di test è un file che contiene informazioni sull'esecuzione e sul risultato dei test.

Report di test di Visual Studio

Il file dei risultati del test di Visual Studio (o TRX) è il formato predefinito per la pubblicazione dei risultati dei test. Questa estensione viene fornita come parte del pacchetto Microsoft.Testing.Extensions.TrxReport.

Le opzioni disponibili sono le seguenti:

Opzione	Descrizione
--report-trx	Genera il report TRX.
--report-trx-filename	Nome del rapporto TRX generato. Il nome predefinito corrisponde al formato seguente <UserName>_<MachineName>_<yyyy-MM-dd HH:mm:ss>.trx.

Il report viene salvato all'interno della cartella predefinita TestResults che può essere specificata tramite l'argomento della riga di comando --results-directory.

Report di Azure DevOps

Il plug-in di report di Azure DevOps migliora l'esecuzione dei test per gli sviluppatori che ospitano il codice in GitHub, ma si basano sugli agenti di compilazione di Azure DevOps. Aggiunge informazioni aggiuntive agli errori per mostrare l'errore direttamente in GitHub PR.

L'estensione viene fornita nel pacchetto Microsoft.Testing.Extensions.AzureDevOpsReport .

Le opzioni disponibili sono le seguenti:

Opzione	Descrizione
--report-azdo	Abilitare l'output degli errori o degli avvisi nelle compilazioni CI.
--report-azdo-severity	Gravità da usare per l'evento segnalato. Le opzioni sono: error (impostazione predefinita) e warning.

L'estensione rileva automaticamente che è in esecuzione nell'ambiente di integrazione continua (CI) controllando la TF_BUILD variabile di ambiente.

Determinazione della riga da segnalare

Per evidenziare la riga corretta nel codice in cui si è verificato l'errore, il plug-in del report AzureDevOps cerca un file presente nel repository corrente.

Per determinarlo:

• trova la radice del repository, questa operazione viene eseguita eseguendo una ricerca nella .git directory più vicina al percorso da cui viene avviata l'applicazione di test (come determinato da AppContext.BaseDirectory).
• trova la prima riga nell'analisi dello stack con la posizione e la riga del file (la libreria deve avere simboli di debug).
• esclude tutti i file che terminano con Assert.cs per evitare di visualizzare i dettagli delle implementazioni o dei wrapper dell'asserzione.
• esclude tutti i file che non esistono su disco (in genere sono righe di librerie esterne che includono simboli di debug, ad esempio MSTest).

Si tratta di dettagli interni utili per facilitare il debug del comportamento e potrebbero cambiare in futuro.