Configurar o MSTest

MSTest, Microsoft Testing Framework, é uma estrutura de teste para aplicativos .NET. Ele permite que você escreva e execute testes e forneça pacotes de teste com integração com Visual Studio e Visual Studio Code Test Explorers, a CLI do .NET e muitos pipelines de CI.

O MSTest é uma estrutura de teste totalmente suportada, de código aberto e multiplataforma que funciona com todos os destinos .NET suportados (.NET Framework, .NET Core, .NET, UWP, WinUI e assim por diante) hospedados no GitHub.

Configurações de execução

Um arquivo .runsettings pode ser usado para configurar como os testes de unidade estão sendo executados. Para saber mais sobre as runsettings e as configurações relacionadas à plataforma, você pode verificar a documentação runsettings do VSTest ou a documentação runsettings do MSTest runner.

Elemento MSTest

As seguintes entradas runsettings permitem configurar como o MSTest se comporta.

Configuração	Predefinido	Valores
AssemblyCleanupTimeout	0	Especifique globalmente o tempo limite a ser aplicado em cada instância do método de limpeza de assembly. [Timeout] atributo especificado no método de limpeza de assembly substitui o tempo limite global .
AssemblyInitializeTimeout	0	Especifique globalmente o tempo limite a ser aplicado em cada instância do método de inicialização do assembly. [Timeout] especificado no método de inicialização do assembly substitui o tempo limite global.
AssembleiaResolução	false	Você pode especificar caminhos para assemblies extras ao localizar e executar testes de unidade. Por exemplo, use esses caminhos para assemblies de dependência que não estão no mesmo diretório que o assembly de teste. Para especificar um caminho, use um elemento Directory Path . Os caminhos podem incluir variáveis de ambiente. <AssemblyResolution> <Directory path="D:\myfolder\bin\" includeSubDirectories="false"/> </AssemblyResolution> Esse recurso só é aplicado ao usar um destino do .NET Framework.
CaptureTraceOutput	verdadeiro	Capture mensagens de texto provenientes do Console.Write*, Trace.Write*e Debug.Write* APIs que serão associadas ao teste em execução atual.
ClassCleanupLifecycle	Fim de Classe	Se desejar que a limpeza de classe ocorra no final da montagem, defina-a como EndOfAssembly. (Não há mais suporte a partir do MSTest v4, pois EndOfClass é o padrão e apenas Comportamento ClassCleanup )
ClassCleanupTimeout	0	Especifique globalmente o tempo limite a ser aplicado em cada instância do método de limpeza de classe. [Timeout] atributo especificado no método de limpeza de classe substitui o tempo limite global.
ClassInitializeTimeout	0	Especifique globalmente o tempo limite a ser aplicado em cada instância do método de inicialização de classe. [Timeout] atributo especificado no método de inicialização de classe substitui o tempo limite global.
DeleteDeploymentDirectoryAfterTestRunIsComplete	verdadeiro	Para manter o diretório de implantação após uma execução de teste, defina esse valor como false.
DeploymentEnabled	verdadeiro	Se você definir o valor como false, os itens de implantação especificados no método de teste não serão copiados para o diretório de implantação.
DeployTestSourceDependencies	verdadeiro	Um valor que indica se as referências de origem de teste devem ser implantadas.
EnableBaseClassTestMethodsFromOtherAssemblies	verdadeiro	Um valor que indica se a descoberta de métodos de teste de classes base deve ser habilitada em um assembly diferente da classe de teste herdeira.
ForcedLegacyMode	false	Em versões mais antigas do Visual Studio, o adaptador MSTest foi otimizado para torná-lo mais rápido e escalável. Alguns comportamentos, como a ordem em que os testes são executados, podem não ser exatamente como era em edições anteriores do Visual Studio. Defina o valor como true para usar o adaptador de teste mais antigo. Por exemplo, você pode usar essa configuração se tiver um arquivo app.config especificado para um teste de unidade. Recomendamos que você considere a refatoração de seus testes para permitir que você use o adaptador mais recente.
MapInconclusiveToFailed	false	Se um teste for concluído com um status inconclusivo, ele será mapeado para o status ignorado no Gerenciador de Testes. Se você quiser que testes inconclusivos sejam mostrados como reprovados, defina o valor como true.
MapNotRunnableToFailed	verdadeiro	Um valor que indica se um resultado não executável é mapeado para teste com falha.
Paralelizar		Usado para definir as configurações de paralelização: Trabalhadores: O número de threads/trabalhadores a serem usados para paralelização, que é, por padrão , o número de processadores na máquina atual. ESCOPO: O escopo da paralelização. Você pode defini-lo como MethodLevel. Por padrão, é ClassLevel. <Parallelize><Workers>32</Workers><Scope>MethodLevel</Scope></Parallelize>
ConfiguraçõesArquivo		Você pode especificar um arquivo de configurações de teste para usar com o adaptador MSTest aqui. Você também pode especificar um arquivo de configurações de teste no menu de configurações. Se você especificar esse valor, também deverá definir o ForcedLegacyMode como true. <ForcedLegacyMode>true</ForcedLegacyMode>
TestCleanupTimeout	0	Especifique globalmente o tempo limite a ser aplicado em cada instância do método de limpeza de teste. [Timeout] atributo especificado no método de limpeza de teste substitui o tempo limite global.
TestInitializeTimeout	0	Especifique globalmente o tempo limite a ser aplicado em cada instância do método de inicialização de teste. [Timeout] atributo especificado no método de inicialização de teste substitui o tempo limite global.
TestTimeout	0	Obtém o tempo limite do caso de teste global especificado.
TreatClassAndAssemblyCleanupWarningsAsErrors	false	Para ver suas falhas nas limpezas de classe como erros, defina esse valor como true.
TreatDiscoveryWarningsAsErrors	false	Para relatar avisos de descoberta de teste como erros, defina esse valor como true.
ConsiderFixturesAsSpecialTests	false	Para exibir AssemblyInitialize, AssemblyCleanup, , ClassInitializecomo ClassCleanup entradas individuais no Visual Studio e no Visual Studio Code Test Explorer e no log .trx , defina esse valor como true

TestRunParameter elemento

<TestRunParameters>
    <Parameter name="webAppUrl" value="http://localhost" />
</TestRunParameters>

Os parâmetros de execução de teste fornecem uma maneira de definir variáveis e valores que estão disponíveis para os testes em tempo de execução. Acesse os parâmetros usando a propriedade MSTest TestContext.Properties :

private string _appUrl;
public TestContext TestContext { get; set; }

[TestMethod]
public void HomePageTest()
{
    string _appUrl = TestContext.Properties["webAppUrl"];
}

Para usar parâmetros de execução de teste, adicione uma propriedade pública TestContext à sua classe de teste.

Exemplo de arquivo .runsettings

O XML a seguir mostra o conteúdo de um arquivo .runsettings típico. Copie este código e edite-o de acordo com as suas necessidades.

Cada elemento do arquivo é opcional porque tem um valor padrão.

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>

  <!-- Parameters used by tests at run time -->
  <TestRunParameters>
    <Parameter name="webAppUrl" value="http://localhost" />
    <Parameter name="webAppUserName" value="Admin" />
    <Parameter name="webAppPassword" value="Password" />
  </TestRunParameters>

  <!-- MSTest -->
  <MSTest>
    <MapInconclusiveToFailed>True</MapInconclusiveToFailed>
    <CaptureTraceOutput>false</CaptureTraceOutput>
    <DeleteDeploymentDirectoryAfterTestRunIsComplete>False</DeleteDeploymentDirectoryAfterTestRunIsComplete>
    <DeploymentEnabled>False</DeploymentEnabled>
    <ConsiderFixturesAsSpecialTests>False</ConsiderFixturesAsSpecialTests>
    <AssemblyResolution>
      <Directory path="D:\myfolder\bin\" includeSubDirectories="false"/>
    </AssemblyResolution>
  </MSTest>

</RunSettings>