dotnet vstest

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

Namn

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

Sammanfattning

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.

Arguments

• TEST_FILE_NAMES

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

Options

• --Blame

  Kör testerna i skuldläge. Det här alternativet är användbart när du isolerar problematiska tester som gör att testvärden kraschar. Den skapar en utdatafil i den aktuella katalogen som Sequence.xml som samlar in körningsordningen för testerna 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 av .NET Framework som används för testkörning. Ett exempel på ett giltigt värde är .NETFramework,Version=v7.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 logger för testresultat.

  • Om du vill publicera testresultat till Team Foundation Server använder du loggerprovidern 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>]
    

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

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

• --Parallel

  Kör 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 process 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>

  Testresultatkatalogen 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 någon) i testkörningen.

• --TestCaseFilter <EXPRESSION>

  Kör tester som matchar det angivna uttrycket. <EXPRESSION> är av 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 separera flera argument.

Examples

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