dotnet vstest

  • Artículo

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

Importante

El comando dotnet vstest se sustituye por dotnet test, que ahora se puede usar para ejecutar ensamblados. Consulte dotnet test.

NOMBRE

dotnet vstest: permite ejecutar pruebas a partir 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

Descripción

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

Argumentos

  • TEST_FILE_NAMES

    Ejecutar pruebas desde los ensamblados especificados. Separar varios nombres de ensamblado de prueba con espacios. Se admite caracteres comodín.

Opciones

  • --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 pruebas antes del bloqueo.

  • --Diag <PATH_TO_LOG_FILE>

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

  • --Framework <FRAMEWORK>

    Identificar la versión de .NET Framework usada en la ejecución de pruebas. Ejemplos de valores válidos son .NETFramework,Version=v4.6 o .NETCoreApp,Version=v1.0. Otros valores admitidos son Framework40, Framework45, FrameworkCore10 y FrameworkUap10.

  • --InIsolation

    Ejecuta las pruebas en un proceso aislado. De este modo, es menos probable que el proceso vstest.console.exe se detenga por un error de las pruebas, pero es posible que las pruebas se ejecuten más despacio.

  • -lt|--ListTests <FILE_NAME>

    Muestra todas las pruebas detectadas del contenedor de pruebas especificado.

  • --logger <LOGGER_URI/FRIENDLY_NAME>

    Especifica un registrador para resultados de pruebas.

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

      /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 de registrador trx. Este modificador, crea un archivo en el directorio de resultados de pruebas con un nombre de archivo de registro dado. Si no se proporciona LogFileName, se crea un nombre de archivo único para contener los resultados de las pruebas.

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

  • --Parallel

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

  • --ParentProcessId <PROCESS_ID>

    Id. de proceso del proceso principal responsable de iniciar el proceso actual.

  • --Platform <PLATFORM_TYPE>

    Identificar la arquitectura de la plataforma usada en la ejecución de pruebas. Valores válidos son x86, x64 y ARM.

  • --Port <PORT>

    Especifica el puerto para la conexión de socket y la recepción de mensajes de eventos.

  • --ResultsDirectory:<PATH>

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

  • --Settings <SETTINGS_FILE>

    Configuración que se usará al ejecutar las pruebas.

  • --TestAdapterPath <PATH>

    Usar adaptadores de prueba personalizados desde una ruta de acceso especificada (si existe) en la serie de pruebas.

  • --TestCaseFilter <EXPRESSION>

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

  • --Tests <TEST_NAMES>

    Ejecuta las pruebas con nombres que coinciden con los Separar varios valores con comas.

  • -?|--Help

    Imprime una corta ayuda para el comando.

  • @<file>

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

  • args

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

Ejemplos

Ejecución de pruebas en mytestproject.dll:

dotnet vstest mytestproject.dll

Ejecución de pruebas en mytestproject.dll, exportación a una carpeta personalizada con nombre personalizado:

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

Ejecución de pruebas en mytestproject.dll y myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Ejecutar pruebas TestMethod1:

dotnet vstest /Tests:TestMethod1

Ejecutar pruebas TestMethod1 y TestMethod2:

dotnet vstest /Tests:TestMethod1,TestMethod2

Vea también