Diagnóstico

Estas extensões recolhem evidências durante um teste para que possas diagnosticar falhas posteriormente. Cada extensão requer um pacote NuGet adicional, conforme descrito em cada secção.

Gorjeta

Ao usar o Microsoft.Testing.Platform.MSBuild (incluído de forma transitiva pelos runners MSTest, NUnit e xUnit), estas extensões são registadas automaticamente quando instala os seus pacotes NuGet — não são necessárias alterações de código. O registo manual especificado neste artigo só é obrigatório se desativar o ponto de entrada gerado automaticamente ao definir <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Para diagnósticos de nível de processo, consulte as extensões relacionadas despejos por falha e bloqueio, que recolhem ficheiros de despejo do processo quando o anfitrião de teste falha ou bloqueia.

Gravador de vídeo

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

Note

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

Registo manual

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

Opções

Option	Versão MTP	Description
--capture-video	2.3.0	Ativa a gravação do ecrã. O valor opcional controla a retenção: on-failure (por defeito) mantém as imagens apenas para testes falhados e always para todos os testes.
--capture-video-source	2.3.0	Define a fonte de captura. Os valores válidos são screen (por defeito) 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 dividido em capítulos durante toda a execução. Os valores válidos são test (por defeito) e session. Requer --capture-video.
--capture-video-max-duration	2.3.0	Limita a utilização do disco durante execuções prolongadas, mantendo aproximadamente os últimos N segundos de gravação. O valor é um número inteiro positivo de segundos. Requer --capture-video.
--capture-video-chapters	2.3.0	Define se os marcadores de capítulos são adicionados ao vídeo por sessão. Os valores válidos são on (por defeito) e off. Requer --capture-video.
--capture-video-args	2.3.0	Passa argumentos extra ao gravador subjacente (ffmpeg). Requer --capture-video.