Diagnostica

Queste estensioni acquisiscono l'evidenza durante un'esecuzione di test in modo da poter diagnosticare gli errori dopo il fatto. Ogni estensione richiede un pacchetto NuGet aggiuntivo, come descritto in ogni sezione.

Tip

Quando si usa Microsoft.Testing.Platform.MSBuild (incluso transitivamente da MSTest, NUnit e runner xUnit), queste estensioni vengono registrate automaticamente quando si installano i pacchetti NuGet, senza necessità di modifiche al codice. La registrazione manuale specificata in questo articolo è necessaria solo se il punto di ingresso generato automaticamente è stato disabilitato impostando <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Per la diagnostica a livello di processo, vedere le estensioni correlate Dump di arresto anomalo e blocco, che raccolgono i file dump del processo quando l'host di test si arresta in modo anomalo o si blocca.

Videoregistratore

Il videoregistratore registra lo schermo durante l'esecuzione dei test e collega i video acquisiti alla sessione di test come artefatti. La registrazione è facoltativa per ogni esecuzione ed è gestita da un processo esterno ffmpeg, che deve essere disponibile su PATH o specificato tramite un percorso esplicito. Questa estensione richiede il pacchetto NuGet Microsoft.Testing.Extensions.VideoRecorder.

Note

Disponibile in MTP a partire dalla versione 2.3.0. Questa estensione è sperimentale e le opzioni e il formato di output potrebbero cambiare in una versione futura.

Registrazione manuale

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddVideoRecorderProvider();

Options

Opzione Versione MTP Description
--capture-video 2.3.0 Abilita la registrazione dello schermo. Il valore facoltativo controlla la conservazione: on-failure (impostazione predefinita) mantiene il filmato solo per i test non superati e always mantiene il filmato per ogni test.
--capture-video-source 2.3.0 Imposta l'origine di acquisizione. I valori validi sono screen (impostazione predefinita) e window. Richiede --capture-video.
--capture-video-granularity 2.3.0 Imposta se il registratore produce un video per test o un video con capitoli per l'intera esecuzione. I valori validi sono test (impostazione predefinita) e session. Richiede --capture-video.
--capture-video-max-duration 2.3.0 Limita l'utilizzo del disco durante esecuzioni prolungate conservando approssimativamente solo gli ultimi N secondi di filmato. Il valore è un numero intero positivo di secondi. Richiede --capture-video.
--capture-video-chapters 2.3.0 Imposta un valore che indica se i segnalibri del capitolo vengono aggiunti al video per sessione. I valori validi sono on (impostazione predefinita) e off. Richiede --capture-video.
--capture-video-args 2.3.0 Passa argomenti aggiuntivi al registratore sottostante (ffmpeg). Richiede --capture-video.