Referens för CLI-alternativ för Microsoft.Testing.Platform

Den här artikeln innehåller en central startpunkt för kommandoradsalternativen Microsoft.Testing.Platform.

Plattformsalternativ

• @

  Anger namnet på svarsfilen. Svarsfilens namn måste omedelbart följa @ tecknet utan blanksteg mellan @ tecknet och svarsfilens namn.

  Alternativ i en svarsfil tolkas som om de fanns på den platsen på kommandoraden. Du kan inte använda omvänt snedstreck \ för att sammanfoga linjer. Att använda en svarsfil hjälper till med mycket långa kommandon som kan överskrida terminalgränserna. Du kan kombinera en svarsfil med infogade kommandoradsargument. Till exempel:

  ./TestExecutable.exe @"filter.rsp" --timeout 10s
  

  där filter.rsp kan ha följande innehåll:

  --filter "A very long filter"
  

  Eller så kan en enskild rsp-fil användas för att ange både tidsgräns och filter på följande sätt:

  ./TestExecutable.exe @"arguments.rsp"
  

  --filter "A very long filter" --timeout 10s
  

  Anmärkning

  När du använder dotnet testanvänder SDK-kommandoradsparsern en token-per-line-metod där varje rad i svarsfilen behandlas som en enda token. I så fall måste varje argument finnas på en separat rad:

  --filter
  A very long filter
  --timeout
  10s
  

• --config-file

  Anger en testconfig.json-fil.

• --diagnostic

  Aktiverar diagnostikloggning. Standardloggnivån är Trace. Filen skrivs i utdatakatalogen med följande namnformat, log_[MMddHHssfff].diag.

• --diagnostic-synchronous-write

  Tvingar den inbyggda filloggaren att synkront skriva loggar. Användbart för scenarier där du inte vill förlora några loggposter (om processen kraschar). Detta gör testkörningen långsammare.

• --diagnostic-output-directory

  Utdatakatalogen för diagnostikloggningen, om den inte anges, genereras filen i standardkatalogen TestResults.

• --diagnostic-file-prefix

  Prefixet för loggfilens namn. Standardinställningen är "log".

• --diagnostic-verbosity

  Definierar verbositetsnivån när växeln --diagnostic används. De tillgängliga värdena är Trace, Debug, Information, Warning, Erroreller Critical.

• --exit-on-process-exit

  Avsluta testprocessen om den beroende processen går ut. PID måste anges.

• --help

  Skriver ut en beskrivning av hur du använder kommandot.

• --ignore-exit-code

  Tillåter att vissa avslutskoder som inte är noll ignoreras och i stället returneras som 0. Mer information finns i Ignorera specifika slutkoder.

• --info

  Visar avancerad information om .NET testprogrammet, till exempel:

  • Plattformen.
  • Miljön.
  • Varje registrerad kommandoradsleverantör, till exempel dess name, version, descriptionoch options.
  • Varje registrerat verktyg, till exempel dess command, name, version, descriptionoch alla kommandoradsleverantörer.

  Den här funktionen används för att förstå tillägg som skulle registrera samma kommandoradsalternativ eller ändringar i tillgängliga alternativ mellan flera versioner av ett tillägg (eller plattformen).

• --list-tests

  Lista tillgängliga tester. Tester kommer inte att köras.

• --maximum-failed-tests

  Anger det maximala antalet testfel som, när den nås, stoppar testkörningen. Stöd för den här växeln kräver att ramverksförfattare implementerar funktionen IGracefulStopTestExecutionCapability. Slutkoden när du når den mängden testfel är 13. Mer information finns i Microsoft.Testing.Platform utgångskoder.

  Anmärkning

  Den här funktionen är tillgänglig i Microsoft.Testing.Platform från och med version 1.5.

• --minimum-expected-tests

  Anger det minsta antalet tester som förväntas köras. Som standard förväntas minst ett test köras.

• --results-directory

  Katalogen där testresultaten ska placeras. Om den angivna katalogen inte finns skapas den. Standardvärdet är TestResults i katalogen som innehåller testprogrammet.

• --timeout

  En tidsgräns för global testexekvering. Tar ett argument som sträng i formatet <value>[h|m|s] där <value> är flyttal.

Tilläggsalternativ efter scenario

Använd följande tabell för att snabbt hitta tilläggsalternativ.

Identifiera alternativ i testappen

Kör ditt körbara testprogram med --help för att lista alternativen som är tillgängliga för din aktuella tilläggsuppsättning.

För avancerad diagnostik av registrerade leverantörer och alternativ kör du med --info.

Se även

• Översikt över Microsoft.Testing.Platform
• Microsoft.Testing.Platform-funktioner
• Testa med dotnet test