dotnet vstest
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.
dotnet vstest
: permite ejecutar pruebas a partir de los ensamblados especificados.
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
El comando dotnet vstest
ejecuta la aplicación de línea de comandos VSTest.Console
para ejecutar pruebas unitarias automatizadas.
TEST_FILE_NAMES
Ejecutar pruebas desde los ensamblados especificados. Separar varios nombres de ensamblado de prueba con espacios. Se admite caracteres comodín.
--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 sonFramework40
,Framework45
,FrameworkCore10
yFrameworkUap10
.--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
:Consola/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 proporcionaLogFileName
, se crea un nombre de archivo único para contener los resultados de las pruebas.Consola/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 nodoRunConfiguration
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
yARM
.--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 comoDisplayName
. 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.
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
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: