dotnet vstest

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

Importante

El dotnet vstest comando se reemplaza por dotnet test, que ahora se puede usar para ejecutar ensamblados. Consulte dotnet test( Prueba de dotnet).

Nombre

dotnet vstest - Ejecuta pruebas de los ensamblados especificados.

Sinopsis

dotnet vstest [<TEST_FILE_NAMES>] [--Blame] [--Diag <PATH_TO_LOG_FILE>]
    [--Framework <FRAMEWORK>] [--InIsolation] [-lt|--ListTests <FILE_NAME>]
    [--logger <LOGGER_URI/FRIENDLY_NAME>] [--Parallel]
    [--ParentProcessId <PROCESS_ID>] [--Platform] <PLATFORM_TYPE>
    [--Port <PORT>] [--ResultsDirectory<PATH>] [--Settings <SETTINGS_FILE>]
    [--TestAdapterPath <PATH>] [--TestCaseFilter <EXPRESSION>]
    [--Tests <TEST_NAMES>] [[--] <args>...]

dotnet vstest -?|--Help

Description

El dotnet vstest comando ejecuta la VSTest.Console aplicación de línea de comandos para ejecutar pruebas unitarias automatizadas.

Arguments

• TEST_FILE_NAMES

  Ejecute pruebas a partir de los ensamblados especificados. Separe varios nombres de ensamblado de prueba con espacios. Se admite caracteres comodín.

Options

• --Blame

  Ejecuta las pruebas en el modo de culpabilidad. Esta opción es útil para aislar las pruebas problemáticas que hacen que el host de prueba se bloquee. Crea un archivo de salida en el directorio actual como Sequence.xml que captura el orden de ejecución de las pruebas antes del bloqueo.

• --Diag <PATH_TO_LOG_FILE>

  Habilita registros detallados para la plataforma de prueba. Los registros se escriben en el archivo proporcionado.

• --Framework <FRAMEWORK>

  Versión de .NET Framework de destino que se usa para la ejecución de pruebas. Un ejemplo de un valor válido es .NETFramework,Version=v7.0. Otros valores admitidos son Framework40, Framework45, FrameworkCore10y FrameworkUap10.

• --InIsolation

  Ejecuta las pruebas en un proceso aislado. Esto hace quevstest.console.exe proceso sea menos probable que se detenga en un error en las pruebas, pero las pruebas se pueden ejecutar más lentamente.

• -lt|--ListTests <FILE_NAME>

  Enumera todas las pruebas detectadas del contenedor de pruebas especificado.

• --logger <LOGGER_URI/FRIENDLY_NAME>

  Especifique un registrador para los resultados de la prueba.

  • Para publicar resultados de pruebas en Team Foundation Server, use el proveedor del TfsPublisher registrador:

    /logger:TfsPublisher;
        Collection=<team project collection url>;
        BuildName=<build name>;
        TeamProject=<team project name>
        [;Platform=<Defaults to "Any CPU">]
        [;Flavor=<Defaults to "Debug">]
        [;RunTitle=<title>]
    

  • Para registrar los resultados en un archivo de resultados de pruebas (TRX) de Visual Studio, use el proveedor del trx registrador. Este modificador crea un archivo en el directorio de resultados de la prueba con un nombre de archivo de registro determinado. Si LogFileName no se proporciona, se crea un nombre de archivo único para contener los resultados de la prueba.

    /logger:trx [;LogFileName=<Defaults to unique file name>]
    

• --Parallel

  Ejecuta pruebas en paralelo. De forma predeterminada, todos los núcleos disponibles en la máquina están disponibles para su uso. Especifique un número explícito de núcleos estableciendo la MaxCpuCount propiedad en el RunConfiguration nodo en el archivo runsettings .

• --ParentProcessId <PROCESS_ID>

  Identificador de proceso del proceso primario responsable de iniciar el proceso actual.

• --Platform <PLATFORM_TYPE>

  Arquitectura de plataforma de destino que se usa para la ejecución de pruebas. Los valores válidos son x86, x64y ARM.

• --Port <PORT>

  Especifica el puerto de la conexión de socket y la recepción de los mensajes de evento.

• --ResultsDirectory:<PATH>

  Si no existe, se creará el directorio de resultados de pruebas en la ruta de acceso especificada.

• --Settings <SETTINGS_FILE>

  Configuración que se va a usar al ejecutar pruebas.

• --TestAdapterPath <PATH>

  Use adaptadores de prueba personalizados desde una ruta de acceso determinada (si existe) en la ejecución de pruebas.

• --TestCaseFilter <EXPRESSION>

  Ejecute pruebas que coincidan con la expresión especificada. <EXPRESSION> es del formato <property>Operator<value>[|&<EXPRESSION>], donde Operator es uno de =, !=o ~. El operador ~ tiene la semántica "contains" y es aplicable a las propiedades de cadena como DisplayName. Los paréntesis () se usan para agrupar subexpresiones. Para obtener más información, consulte Filtro TestCase.

• --Tests <TEST_NAMES>

  Ejecute pruebas con nombres que coincidan con los valores proporcionados. Separe los distintos valores mediante comas.

• -?|--Help

  Imprime una breve ayuda para el comando.

• @<file>

  Lee el archivo de respuesta para obtener más opciones.

• args

  Especifica argumentos adicionales para pasar al adaptador. Los argumentos se especifican como pares nombre-valor del formulario <n>=<v>, donde <n> es el nombre del argumento y <v> es el valor del argumento. Use un espacio para separar varios argumentos.

Examples

Ejecutar pruebas en mytestproject.dll:

dotnet vstest mytestproject.dll

Ejecute pruebas en mytestproject.dll, exportando a la carpeta personalizada con el nombre personalizado:

dotnet vstest mytestproject.dll --logger:"trx;LogFileName=custom_file_name.trx" --ResultsDirectory:custom/file/path

Ejecute pruebas en mytestproject.dll y myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Ejecutar TestMethod1 pruebas:

dotnet vstest /Tests:TestMethod1

Ejecutar TestMethod1 y TestMethod2 probar:

dotnet vstest /Tests:TestMethod1,TestMethod2

Consulte también

• VSTest.Console.exe opciones de línea de comandos