dotnet test

Este artículo se aplica a: ✔️ SDK de .NET 6 y versiones posteriores

NOMBRE

dotnet test: controlador de prueba de .NET usado para ejecutar pruebas unitarias.

Descripción

El comando dotnet test compila la solución y ejecuta las pruebas con VSTest o Microsoft Testing Platform (MTP). El ejecutor de pruebas que usa determina las opciones y el comportamiento disponibles de la línea de comandos.

Nota:

La selección del ejecutor de pruebas está disponible a partir del SDK de .NET 10. En versiones anteriores de .NET, las pruebas siempre se ejecutan con VSTest.

Elección de un ejecutor de pruebas

Con el SDK de .NET 10 y versiones posteriores, seleccione Microsoft. Testing.Platform (MTP) en el global.json archivo:

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

Nota:

VSTest es un valor válido para el ejecutor de pruebas. Es el valor predeterminado actual y se puede omitir.

Importante

La dotnet test experiencia de MTP solo se admite en Microsoft.Testing.Platform la versión 1.7 y posteriores.

A partir de .NET 11 Preview 6, establezca la DOTNET_TEST_RUNNER variable de entorno para seleccionar el ejecutor sin cambiar global.json. La variable de entorno acepta VSTest o Microsoft.Testing.Platform, sin tener en cuenta el caso, e invalida el global.json valor:

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

Si la variable de entorno está vacía o contiene un valor no reconocido, dotnet test usa el global.json valor . Si ninguna opción selecciona un ejecutor, dotnet test usa VSTest.

Documentación del ejecutor de pruebas

Las opciones, el comportamiento y las funcionalidades disponibles de la línea de comandos difieren en función del ejecutor de pruebas que use:

  • dotnet test con VSTest : la plataforma de prueba tradicional, disponible en el SDK de .NET 6 y versiones posteriores. Este es el ejecutor de pruebas predeterminado y solo en versiones anteriores al SDK de .NET 10. Proporciona funcionalidades completas de detección, filtrado y generación de informes de resultados.

  • dotnet test con MTP: la plataforma de pruebas moderna, disponible en el SDK de .NET 10 y versiones posteriores. Ofrece una ejecución de pruebas más rápida y una selección más flexible del módulo de prueba.

Sugerencia

Para obtener documentación conceptual sobre dotnet test, consulte Pruebas con prueba de dotnet.

Vea también