Diagnóstico

Essas extensões capturam evidências durante uma execução de teste para que você possa diagnosticar falhas após o fato. Cada extensão requer um pacote NuGet adicional, conforme descrito em cada seção.

Dica

Ao usar o Microsoft.Testing.Platform.MSBuild (incluído transitivamente por MSTest, NUnit e xUnit runners), essas extensões são registradas automaticamente quando você instala seus pacotes NuGet , sem necessidade de alterações de código. O registro manual especificado neste artigo só será necessário se você desabilitar o ponto de entrada gerado automaticamente definindo <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Para diagnósticos no nível do processo, consulte as extensões relacionadas Despejos de falha e travamento, que coletam arquivos de despejo de processo quando o host de teste falha ou trava.

Gravador de vídeo

O gravador de vídeo grava a tela enquanto os testes são executados e anexa os vídeos capturados à sessão de teste como artefatos. A gravação é opcional por execução e acionada por um processo externo ffmpeg, que deve estar disponível em PATH ou ser especificado por um caminho explícito. Essa extensão requer o pacote NuGet Microsoft.Testing.Extensions.VideoRecorder.

Note

Disponível no MTP a partir da versão 2.3.0. Essa extensão é experimental e suas opções e formato de saída podem mudar em uma versão futura.

Registro manual

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

Opções

Opção	Versão do MTP	Description
--capture-video	2.3.0	Habilita a gravação de tela. O valor opcional controla a retenção: on-failure (padrão) mantém a filmagem apenas para testes com falha e always mantém imagens para cada teste.
--capture-video-source	2.3.0	Define a origem da captura. Os valores válidos são screen (padrão) e window. Requer --capture-video.
--capture-video-granularity	2.3.0	Define se o gravador produz um vídeo por teste ou um vídeo com capítulos para toda a execução. Os valores válidos são test (padrão) e session. Requer --capture-video.
--capture-video-max-duration	2.3.0	Limita o uso de disco em execuções longas mantendo aproximadamente os últimos N segundos de filmagem. O valor é um número inteiro positivo de segundos. Requer --capture-video.
--capture-video-chapters	2.3.0	Determina se os marcadores de capítulo são adicionados ao vídeo de cada sessão. Os valores válidos são on (padrão) e off. Requer --capture-video.
--capture-video-args	2.3.0	Passa argumentos extras para o gravador subjacente (ffmpeg). Requer --capture-video.