dotnet vstest

Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner

Viktigt

Kommandot dotnet vstest ersätts av dotnet test, som nu kan användas för att köra sammansättningar. Se dotnet-test.

Name

dotnet vstest – Kör tester från de angivna sammansättningarna.

Synopsis

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

Kommandot dotnet vstest kör VSTest.Console kommandoradsprogrammet för att köra automatiserade enhetstester.

Argument

• TEST_FILE_NAMES

  Kör tester från de angivna sammansättningarna. Avgränsa flera testsammansättningsnamn med blanksteg. Jokertecken stöds.

Alternativ

• --Blame

  Kör testerna i skuldläge. Det här alternativet är användbart för att isolera problematiska tester som orsakar att testvärden kraschar. Den skapar en utdatafil i den aktuella katalogen som Sequence.xml som registrerar ordningen på testkörningen före kraschen.

• --Diag <PATH_TO_LOG_FILE>

  Aktiverar utförliga loggar för testplattformen. Loggar skrivs till den angivna filen.

• --Framework <FRAMEWORK>

  Målversion .NET Framework som används för testkörning. Exempel på giltiga värden är .NETFramework,Version=v4.6 eller .NETCoreApp,Version=v1.0. Andra värden som stöds är Framework40, Framework45, FrameworkCore10och FrameworkUap10.

• --InIsolation

  Kör testerna i en isolerad process. Detta gör vstest.console.exe processen mindre sannolikt att stoppas vid ett fel i testerna, men testerna kan köras långsammare.

• -lt|--ListTests <FILE_NAME>

  Visar en lista över alla identifierade tester från den angivna testcontainern.

• --logger <LOGGER_URI/FRIENDLY_NAME>

  Ange en loggare för testresultat.

  • Om du vill publicera testresultat till Team Foundation Server använder du TfsPublisher loggningsprovidern:

    /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>]
    

  • Om du vill logga resultat till en TRX-fil (Test Results File) i trx Visual Studio använder du loggningsprovidern. Den här växeln skapar en fil i katalogen för testresultat med det angivna loggfilsnamnet. Om LogFileName inte anges skapas ett unikt filnamn för att lagra testresultaten.

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

• --Parallel

  Köra tester parallellt. Som standard är alla tillgängliga kärnor på datorn tillgängliga för användning. Ange ett explicit antal kärnor genom att ange MaxCpuCount egenskapen under RunConfiguration noden i filen runsettings .

• --ParentProcessId <PROCESS_ID>

  Process-ID för den överordnade processen som ansvarar för att starta den aktuella processen.

• --Platform <PLATFORM_TYPE>

  Målplattformsarkitektur som används för testkörning. Giltiga värden är x86, x64och ARM.

• --Port <PORT>

  Anger porten för socketanslutningen och tar emot händelsemeddelandena.

• --ResultsDirectory:<PATH>

  Katalogen testresultat skapas i den angivna sökvägen om den inte finns.

• --Settings <SETTINGS_FILE>

  Inställningar som ska användas när du kör tester.

• --TestAdapterPath <PATH>

  Använd anpassade testkort från en viss sökväg (om det finns några) i testkörningen.

• --TestCaseFilter <EXPRESSION>

  Kör tester som matchar det angivna uttrycket. <EXPRESSION> har formatet <property>Operator<value>[|&<EXPRESSION>], där Operator är en av =, !=eller ~. Operatorn ~ har semantiken "contains" och gäller för strängegenskaper som DisplayName. Parenteser () används för att gruppera underuttryck. Mer information finns i TestCase-filtret.

• --Tests <TEST_NAMES>

  Kör tester med namn som matchar de angivna värdena. Avgränsa flera värden med kommatecken.

• -?|--Help

  Skriver ut en kort hjälp för kommandot.

• @<file>

  Läser svarsfilen för fler alternativ.

• args

  Anger extra argument som ska skickas till adaptern. Argument anges som namn/värde-par i formuläret <n>=<v>, där <n> är argumentnamnet och <v> är argumentvärdet. Använd ett blanksteg för att avgränsa flera argument.

Exempel

Kör tester i mytestproject.dll:

dotnet vstest mytestproject.dll

Kör tester i mytestproject.dlloch exportera till en anpassad mapp med anpassat namn:

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

Kör tester i mytestproject.dll och myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Kör TestMethod1 tester:

dotnet vstest /Tests:TestMethod1

Kör TestMethod1 och TestMethod2 testa:

dotnet vstest /Tests:TestMethod1,TestMethod2

Se även

• VSTest.Console.exe kommandoradsalternativ