teste dotnet

Este artigo aplica-se a: ✔️ .NET 6 SDK e versões posteriores

Nome

dotnet test - Driver de teste .NET usado para executar testes de unidade.

Descrição

O comando dotnet test cria a solução e executa os testes com VSTest ou Microsoft Testing Platform (MTP). O executor de testes que utiliza determina as opções e comportamentos disponíveis na linha de comandos.

Observação

A seleção do executor de testes está disponível a partir do SDK .NET 10. Nas versões anteriores do .NET, os testes são sempre executados com VSTest.

Escolha um corredor de testes

Com o SDK .NET 10 e versões posteriores, selecione Microsoft. Testing.Platform (MTP) no global.json ficheiro:

{
    "test": {
        "runner": "Microsoft.Testing.Platform"
    }
}

Observação

VSTest é um valor válido para corredor de testes. É o padrão atual e pode ser omitido.

Importante

A dotnet test experiência para MTP só é suportada na Microsoft.Testing.Platform versão 1.7 e posterior.

A partir do .NET 11 Preview 6, defina a DOTNET_TEST_RUNNER variável ambiente para selecionar o runner sem alterar global.json. A variável de ambiente aceita VSTest ou Microsoft.Testing.Platform, sem considerar o caso, e sobrepõe-se ao global.json valor:

$env:DOTNET_TEST_RUNNER = "Microsoft.Testing.Platform"
dotnet test
DOTNET_TEST_RUNNER=Microsoft.Testing.Platform dotnet test

Se a variável de ambiente estiver vazia ou contiver um valor não reconhecido, dotnet test usa esse global.json valor. Se nenhuma das definições selecionar um runner, usa dotnet test VSTest.

Documentação do executor de testes

As opções, comportamentos e capacidades disponíveis na linha de comandos variam consoante o executor de testes que utiliza:

  • dotnet test com VSTest - A plataforma de teste tradicional, disponível em .NET 6 SDK e posteriores. Este é o executor de testes padrão e único em versões anteriores ao .NET 10 SDK. Fornece capacidades abrangentes de descoberta de testes, filtragem e reporte de resultados.

  • dotnet test com MTP - A plataforma moderna de testes, disponível em .NET 10 SDK e posteriores. Oferece execução de testes mais rápida e seleção de módulos de teste mais flexível.

Sugestão

Para obter documentação conceitual sobre dotnet testo , consulte Testando com o teste dotnet.

Consulte também