Delen via


VSTest@2 - Visual Studio Test v2-taak

Gebruik deze taak om eenheids- en functionele tests (Selenium, Appium, Coded UI-test, enzovoort) uit te voeren met behulp van de Visual Studio Test-runner (VSTest). U kunt testframeworks uitvoeren met een Visual Studio-testadapter. Voorbeelden van frameworks zijn MSTest, xUnit, NUnit, Chutzpah (voor JavaScript-tests met QUnit, Mocha en Jasmine), enzovoort. Tests kunnen worden gedistribueerd op meerdere agents met behulp van deze taak.

Notitie

VSTest@2 is de nieuwste versie van de taak en moet worden gebruikt in uw pijplijnen.

Syntax

# Visual Studio Test v2
# Run unit and functional tests (Selenium, Appium, Coded UI test, etc.) using the Visual Studio Test (VsTest) runner. Test frameworks that have a Visual Studio test adapter such as MsTest, xUnit, NUnit, Chutzpah (for JavaScript tests using QUnit, Mocha and Jasmine), etc. can be run. Tests can be distributed on multiple agents using this task (version 2).
- task: VSTest@2
  inputs:
  # Test selection
    testSelector: 'testAssemblies' # 'testAssemblies' | 'testPlan' | 'testRun'. Required. Select tests using. Default: testAssemblies.
    testAssemblyVer2: # string. Required when testSelector = testAssemblies. Test files. 
    #testPlan: # string. Required when testSelector = testPlan. Test plan. 
    #testSuite: # string. Required when testSelector = testPlan. Test suite. 
    #testConfiguration: # string. Required when testSelector = testPlan. Test configuration. 
    #tcmTestRun: '$(test.RunId)' # string. Optional. Use when testSelector = testRun. Test Run. Default: $(test.RunId).
    searchFolder: '$(System.DefaultWorkingDirectory)' # string. Required. Search folder. Default: $(System.DefaultWorkingDirectory).
    #resultsFolder: '$(Agent.TempDirectory)\TestResults' # string. Test results folder. Default: $(Agent.TempDirectory)\TestResults.
    #testFiltercriteria: # string. Optional. Use when testSelector = testAssemblies. Test filter criteria. 
    #runOnlyImpactedTests: False # boolean. Optional. Use when testSelector = testAssemblies. Run only impacted tests. Default: False.
    #runAllTestsAfterXBuilds: '50' # string. Optional. Use when testSelector = testAssemblies && runOnlyImpactedTests = true. Number of builds after which all tests should be run. Default: 50.
    #uiTests: false # boolean. Test mix contains UI tests. Default: false.
  # Execution options
    #vstestLocationMethod: 'version' # 'version' | 'location'. Select test platform using. Default: version.
    #vsTestVersion: 'latest' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | 'toolsInstaller'. Optional. Use when vstestLocationMethod = version. Test platform version. Default: latest.
    #vstestLocation: # string. Optional. Use when vstestLocationMethod = location. Path to vstest.console.exe. 
    #runSettingsFile: # string. Settings file. 
    #overrideTestrunParameters: # string. Override test run parameters. 
    #pathtoCustomTestAdapters: # string. Path to custom test adapters. 
    #runInParallel: False # boolean. Run tests in parallel on multi-core machines. Default: False.
    #runTestsInIsolation: False # boolean. Run tests in isolation. Default: False.
    #codeCoverageEnabled: False # boolean. Code coverage enabled. Default: False.
    #otherConsoleOptions: # string. Other console options. 
    #diagnosticsEnabled: false # boolean. Collect advanced diagnostics in case of catastrophic failures. Default: false.
    #collectDumpOn: 'onAbortOnly' # 'onAbortOnly' | 'always' | 'never'. Optional. Use when diagnosticsEnabled = true. Collect process dump and attach to test run report. Default: onAbortOnly.
    #rerunFailedTests: False # boolean. Rerun failed tests. Default: False.
    #rerunType: 'basedOnTestFailurePercentage' # 'basedOnTestFailurePercentage' | 'basedOnTestFailureCount'. Optional. Use when rerunFailedTests = true. Do not rerun if test failures exceed specified threshold. Default: basedOnTestFailurePercentage.
    #rerunFailedThreshold: '30' # string. Optional. Use when rerunFailedTests = true && rerunType = basedOnTestFailurePercentage. % failure. Default: 30.
    #rerunFailedTestCasesMaxLimit: '5' # string. Optional. Use when rerunFailedTests = true && rerunType = basedOnTestFailureCount. # of failed tests. Default: 5.
    #rerunMaxAttempts: '3' # string. Optional. Use when rerunFailedTests = true. Maximum # of attempts. Default: 3.
  # Advanced execution options
    #distributionBatchType: 'basedOnTestCases' # 'basedOnTestCases' | 'basedOnExecutionTime' | 'basedOnAssembly'. Batch tests. Default: basedOnTestCases.
    #batchingBasedOnAgentsOption: 'autoBatchSize' # 'autoBatchSize' | 'customBatchSize'. Optional. Use when distributionBatchType = basedOnTestCases. Batch options. Default: autoBatchSize.
    #customBatchSizeValue: '10' # string. Required when distributionBatchType = basedOnTestCases && batchingBasedOnAgentsOption = customBatchSize. Number of tests per batch. Default: 10.
    #batchingBasedOnExecutionTimeOption: 'autoBatchSize' # 'autoBatchSize' | 'customTimeBatchSize'. Optional. Use when distributionBatchType = basedOnExecutionTime. Batch options. Default: autoBatchSize.
    #customRunTimePerBatchValue: '60' # string. Required when distributionBatchType = basedOnExecutionTime && batchingBasedOnExecutionTimeOption = customTimeBatchSize. Running time (sec) per batch. Default: 60.
    #dontDistribute: False # boolean. Replicate tests instead of distributing when multiple agents are used in the job. Default: False.
  # Reporting options
    #testRunTitle: # string. Test run title. 
    #platform: # string. Build platform. 
    #configuration: # string. Build configuration. 
    #publishRunAttachments: true # boolean. Upload test attachments. Default: true.
    #failOnMinTestsNotRun: False # boolean. Fail the task if a minimum number of tests are not run. Default: False.
    #minimumExpectedTests: '1' # string. Optional. Use when failOnMinTestsNotRun = true. Minimum # of tests. Default: 1.
# Visual Studio Test v2
# Run unit and functional tests (Selenium, Appium, Coded UI test, etc.) using the Visual Studio Test (VsTest) runner. Test frameworks that have a Visual Studio test adapter such as MsTest, xUnit, NUnit, Chutzpah (for JavaScript tests using QUnit, Mocha and Jasmine), etc. can be run. Tests can be distributed on multiple agents using this task (version 2).
- task: VSTest@2
  inputs:
  # Test selection
    testSelector: 'testAssemblies' # 'testAssemblies' | 'testPlan' | 'testRun'. Required. Select tests using. Default: testAssemblies.
    testAssemblyVer2: # string. Required when testSelector = testAssemblies. Test files. 
    #testPlan: # string. Required when testSelector = testPlan. Test plan. 
    #testSuite: # string. Required when testSelector = testPlan. Test suite. 
    #testConfiguration: # string. Required when testSelector = testPlan. Test configuration. 
    #tcmTestRun: '$(test.RunId)' # string. Optional. Use when testSelector = testRun. Test Run. Default: $(test.RunId).
    searchFolder: '$(System.DefaultWorkingDirectory)' # string. Required. Search folder. Default: $(System.DefaultWorkingDirectory).
    #resultsFolder: '$(Agent.TempDirectory)\TestResults' # string. Test results folder. Default: $(Agent.TempDirectory)\TestResults.
    #testFiltercriteria: # string. Optional. Use when testSelector = testAssemblies. Test filter criteria. 
    #runOnlyImpactedTests: False # boolean. Optional. Use when testSelector = testAssemblies. Run only impacted tests. Default: False.
    #runAllTestsAfterXBuilds: '50' # string. Optional. Use when testSelector = testAssemblies && runOnlyImpactedTests = true. Number of builds after which all tests should be run. Default: 50.
    #uiTests: false # boolean. Test mix contains UI tests. Default: false.
  # Execution options
    #vstestLocationMethod: 'version' # 'version' | 'location'. Select test platform using. Default: version.
    #vsTestVersion: 'latest' # 'latest' | '16.0' | '15.0' | '14.0' | 'toolsInstaller'. Optional. Use when vstestLocationMethod = version. Test platform version. Default: latest.
    #vstestLocation: # string. Optional. Use when vstestLocationMethod = location. Path to vstest.console.exe. 
    #runSettingsFile: # string. Settings file. 
    #overrideTestrunParameters: # string. Override test run parameters. 
    #pathtoCustomTestAdapters: # string. Path to custom test adapters. 
    #runInParallel: False # boolean. Run tests in parallel on multi-core machines. Default: False.
    #runTestsInIsolation: False # boolean. Run tests in isolation. Default: False.
    #codeCoverageEnabled: False # boolean. Code coverage enabled. Default: False.
    #otherConsoleOptions: # string. Other console options. 
    #diagnosticsEnabled: false # boolean. Collect advanced diagnostics in case of catastrophic failures. Default: false.
    #collectDumpOn: 'onAbortOnly' # 'onAbortOnly' | 'always' | 'never'. Optional. Use when diagnosticsEnabled = true. Collect process dump and attach to test run report. Default: onAbortOnly.
    #rerunFailedTests: False # boolean. Rerun failed tests. Default: False.
    #rerunType: 'basedOnTestFailurePercentage' # 'basedOnTestFailurePercentage' | 'basedOnTestFailureCount'. Optional. Use when rerunFailedTests = true. Do not rerun if test failures exceed specified threshold. Default: basedOnTestFailurePercentage.
    #rerunFailedThreshold: '30' # string. Optional. Use when rerunFailedTests = true && rerunType = basedOnTestFailurePercentage. % failure. Default: 30.
    #rerunFailedTestCasesMaxLimit: '5' # string. Optional. Use when rerunFailedTests = true && rerunType = basedOnTestFailureCount. # of failed tests. Default: 5.
    #rerunMaxAttempts: '3' # string. Optional. Use when rerunFailedTests = true. Maximum # of attempts. Default: 3.
  # Advanced execution options
    #distributionBatchType: 'basedOnTestCases' # 'basedOnTestCases' | 'basedOnExecutionTime' | 'basedOnAssembly'. Batch tests. Default: basedOnTestCases.
    #batchingBasedOnAgentsOption: 'autoBatchSize' # 'autoBatchSize' | 'customBatchSize'. Optional. Use when distributionBatchType = basedOnTestCases. Batch options. Default: autoBatchSize.
    #customBatchSizeValue: '10' # string. Required when distributionBatchType = basedOnTestCases && batchingBasedOnAgentsOption = customBatchSize. Number of tests per batch. Default: 10.
    #batchingBasedOnExecutionTimeOption: 'autoBatchSize' # 'autoBatchSize' | 'customTimeBatchSize'. Optional. Use when distributionBatchType = basedOnExecutionTime. Batch options. Default: autoBatchSize.
    #customRunTimePerBatchValue: '60' # string. Required when distributionBatchType = basedOnExecutionTime && batchingBasedOnExecutionTimeOption = customTimeBatchSize. Running time (sec) per batch. Default: 60.
    #dontDistribute: False # boolean. Replicate tests instead of distributing when multiple agents are used in the job. Default: False.
  # Reporting options
    #testRunTitle: # string. Test run title. 
    #platform: # string. Build platform. 
    #configuration: # string. Build configuration. 
    #publishRunAttachments: true # boolean. Upload test attachments. Default: true.
    #failOnMinTestsNotRun: False # boolean. Fail the task if a minimum number of tests are not run. Default: False.
    #minimumExpectedTests: '1' # string. Optional. Use when failOnMinTestsNotRun = true. Minimum # of tests. Default: 1.
# Visual Studio Test v2
# Run unit and functional tests (Selenium, Appium, Coded UI test, etc.) using the Visual Studio Test (VsTest) runner. Test frameworks that have a Visual Studio test adapter such as MsTest, xUnit, NUnit, Chutzpah (for JavaScript tests using QUnit, Mocha and Jasmine), etc. can be run. Tests can be distributed on multiple agents using this task (version 2).
- task: VSTest@2
  inputs:
  # Test selection
    testSelector: 'testAssemblies' # 'testAssemblies' | 'testPlan' | 'testRun'. Required. Select tests using. Default: testAssemblies.
    testAssemblyVer2: # string. Required when testSelector = testAssemblies. Test files. 
    #testPlan: # string. Required when testSelector = testPlan. Test plan. 
    #testSuite: # string. Required when testSelector = testPlan. Test suite. 
    #testConfiguration: # string. Required when testSelector = testPlan. Test configuration. 
    #tcmTestRun: '$(test.RunId)' # string. Optional. Use when testSelector = testRun. Test Run. Default: $(test.RunId).
    searchFolder: '$(System.DefaultWorkingDirectory)' # string. Required. Search folder. Default: $(System.DefaultWorkingDirectory).
    #testFiltercriteria: # string. Optional. Use when testSelector = testAssemblies. Test filter criteria. 
    #runOnlyImpactedTests: False # boolean. Optional. Use when testSelector = testAssemblies. Run only impacted tests. Default: False.
    #runAllTestsAfterXBuilds: '50' # string. Optional. Use when testSelector = testAssemblies && runOnlyImpactedTests = true. Number of builds after which all tests should be run. Default: 50.
    #uiTests: false # boolean. Test mix contains UI tests. Default: false.
  # Execution options
    #vstestLocationMethod: 'version' # 'version' | 'location'. Select test platform using. Default: version.
    #vsTestVersion: 'latest' # 'latest' | '16.0' | '15.0' | '14.0' | 'toolsInstaller'. Optional. Use when vstestLocationMethod = version. Test platform version. Default: latest.
    #vstestLocation: # string. Optional. Use when vstestLocationMethod = location. Path to vstest.console.exe. 
    #runSettingsFile: # string. Settings file. 
    #overrideTestrunParameters: # string. Override test run parameters. 
    #pathtoCustomTestAdapters: # string. Path to custom test adapters. 
    #runInParallel: False # boolean. Run tests in parallel on multi-core machines. Default: False.
    #runTestsInIsolation: False # boolean. Run tests in isolation. Default: False.
    #codeCoverageEnabled: False # boolean. Code coverage enabled. Default: False.
    #otherConsoleOptions: # string. Other console options. 
    #diagnosticsEnabled: false # boolean. Collect advanced diagnostics in case of catastrophic failures. Default: false.
    #collectDumpOn: 'onAbortOnly' # 'onAbortOnly' | 'always' | 'never'. Optional. Use when diagnosticsEnabled = true. Collect process dump and attach to test run report. Default: onAbortOnly.
    #rerunFailedTests: False # boolean. Rerun failed tests. Default: False.
    #rerunType: 'basedOnTestFailurePercentage' # 'basedOnTestFailurePercentage' | 'basedOnTestFailureCount'. Optional. Use when rerunFailedTests = true. Do not rerun if test failures exceed specified threshold. Default: basedOnTestFailurePercentage.
    #rerunFailedThreshold: '30' # string. Optional. Use when rerunFailedTests = true && rerunType = basedOnTestFailurePercentage. % failure. Default: 30.
    #rerunFailedTestCasesMaxLimit: '5' # string. Optional. Use when rerunFailedTests = true && rerunType = basedOnTestFailureCount. # of failed tests. Default: 5.
    #rerunMaxAttempts: '3' # string. Optional. Use when rerunFailedTests = true. Maximum # of attempts. Default: 3.
  # Advanced execution options
    #distributionBatchType: 'basedOnTestCases' # 'basedOnTestCases' | 'basedOnExecutionTime' | 'basedOnAssembly'. Batch tests. Default: basedOnTestCases.
    #batchingBasedOnAgentsOption: 'autoBatchSize' # 'autoBatchSize' | 'customBatchSize'. Optional. Use when distributionBatchType = basedOnTestCases. Batch options. Default: autoBatchSize.
    #customBatchSizeValue: '10' # string. Required when distributionBatchType = basedOnTestCases && batchingBasedOnAgentsOption = customBatchSize. Number of tests per batch. Default: 10.
    #batchingBasedOnExecutionTimeOption: 'autoBatchSize' # 'autoBatchSize' | 'customTimeBatchSize'. Optional. Use when distributionBatchType = basedOnExecutionTime. Batch options. Default: autoBatchSize.
    #customRunTimePerBatchValue: '60' # string. Required when distributionBatchType = basedOnExecutionTime && batchingBasedOnExecutionTimeOption = customTimeBatchSize. Running time (sec) per batch. Default: 60.
    #dontDistribute: False # boolean. Replicate tests instead of distributing when multiple agents are used in the job. Default: False.
  # Reporting options
    #testRunTitle: # string. Test run title. 
    #platform: # string. Build platform. 
    #configuration: # string. Build configuration. 
    #publishRunAttachments: true # boolean. Upload test attachments. Default: true.
# Visual Studio Test v2
# Run unit and functional tests (Selenium, Appium, Coded UI test, etc.) using the Visual Studio Test (VsTest) runner. Test frameworks that have a Visual Studio test adapter such as MsTest, xUnit, NUnit, Chutzpah (for JavaScript tests using QUnit, Mocha and Jasmine), etc. can be run. Tests can be distributed on multiple agents using this task (version 2).
- task: VSTest@2
  inputs:
  # Test selection
    testSelector: 'testAssemblies' # 'testAssemblies' | 'testPlan' | 'testRun'. Required. Select tests using. Default: testAssemblies.
    testAssemblyVer2: # string. Required when testSelector = testAssemblies. Test files. 
    #testPlan: # string. Required when testSelector = testPlan. Test plan. 
    #testSuite: # string. Required when testSelector = testPlan. Test suite. 
    #testConfiguration: # string. Required when testSelector = testPlan. Test configuration. 
    #tcmTestRun: '$(test.RunId)' # string. Optional. Use when testSelector = testRun. Test Run. Default: $(test.RunId).
    searchFolder: '$(System.DefaultWorkingDirectory)' # string. Required. Search folder. Default: $(System.DefaultWorkingDirectory).
    #testFiltercriteria: # string. Optional. Use when testSelector = testAssemblies. Test filter criteria. 
    #runOnlyImpactedTests: False # boolean. Optional. Use when testSelector = testAssemblies. Run only impacted tests. Default: False.
    #runAllTestsAfterXBuilds: '50' # string. Optional. Use when testSelector = testAssemblies && runOnlyImpactedTests = true. Number of builds after which all tests should be run. Default: 50.
    #uiTests: false # boolean. Test mix contains UI tests. Default: false.
  # Execution options
    #vstestLocationMethod: 'version' # 'version' | 'location'. Select test platform using. Default: version.
    #vsTestVersion: 'latest' # 'latest' | '16.0' | '15.0' | '14.0' | 'toolsInstaller'. Optional. Use when vstestLocationMethod = version. Test platform version. Default: latest.
    #vstestLocation: # string. Optional. Use when vstestLocationMethod = location. Path to vstest.console.exe. 
    #runSettingsFile: # string. Settings file. 
    #overrideTestrunParameters: # string. Override test run parameters. 
    #pathtoCustomTestAdapters: # string. Path to custom test adapters. 
    #runInParallel: False # boolean. Run tests in parallel on multi-core machines. Default: False.
    #runTestsInIsolation: False # boolean. Run tests in isolation. Default: False.
    #codeCoverageEnabled: False # boolean. Code coverage enabled. Default: False.
    #otherConsoleOptions: # string. Other console options. 
    #diagnosticsEnabled: True # boolean. Collect advanced diagnostics in case of catastrophic failures. Default: True.
    #collectDumpOn: 'onAbortOnly' # 'onAbortOnly' | 'always' | 'never'. Optional. Use when diagnosticsEnabled = true. Collect process dump and attach to test run report. Default: onAbortOnly.
    #rerunFailedTests: False # boolean. Rerun failed tests. Default: False.
    #rerunType: 'basedOnTestFailurePercentage' # 'basedOnTestFailurePercentage' | 'basedOnTestFailureCount'. Optional. Use when rerunFailedTests = true. Do not rerun if test failures exceed specified threshold. Default: basedOnTestFailurePercentage.
    #rerunFailedThreshold: '30' # string. Optional. Use when rerunFailedTests = true && rerunType = basedOnTestFailurePercentage. % failure. Default: 30.
    #rerunFailedTestCasesMaxLimit: '5' # string. Optional. Use when rerunFailedTests = true && rerunType = basedOnTestFailureCount. # of failed tests. Default: 5.
    #rerunMaxAttempts: '3' # string. Optional. Use when rerunFailedTests = true. Maximum # of attempts. Default: 3.
  # Advanced execution options
    #distributionBatchType: 'basedOnTestCases' # 'basedOnTestCases' | 'basedOnExecutionTime' | 'basedOnAssembly'. Batch tests. Default: basedOnTestCases.
    #batchingBasedOnAgentsOption: 'autoBatchSize' # 'autoBatchSize' | 'customBatchSize'. Optional. Use when distributionBatchType = basedOnTestCases. Batch options. Default: autoBatchSize.
    #customBatchSizeValue: '10' # string. Required when distributionBatchType = basedOnTestCases && batchingBasedOnAgentsOption = customBatchSize. Number of tests per batch. Default: 10.
    #batchingBasedOnExecutionTimeOption: 'autoBatchSize' # 'autoBatchSize' | 'customTimeBatchSize'. Optional. Use when distributionBatchType = basedOnExecutionTime. Batch options. Default: autoBatchSize.
    #customRunTimePerBatchValue: '60' # string. Required when distributionBatchType = basedOnExecutionTime && batchingBasedOnExecutionTimeOption = customTimeBatchSize. Running time (sec) per batch. Default: 60.
    #dontDistribute: False # boolean. Do not distribute tests and replicate instead when multiple agents are used in the job. Default: False.
  # Reporting options
    #testRunTitle: # string. Test run title. 
    #platform: # string. Build platform. 
    #configuration: # string. Build configuration. 
    #publishRunAttachments: true # boolean. Upload test attachments. Default: true.

Invoerwaarden

testSelector - Selecteer tests met behulp van
string. Vereist. Toegestane waarden: testAssemblies (Testassembly's), testPlan (Testplan), testRun (Testuitvoering). Standaardwaarde: testAssemblies.

  • Testassembly: Hiermee geeft u een of meer testassembly's op die uw tests bevatten. U kunt desgewenst een filtercriterium opgeven om alleen specifieke tests te selecteren.
  • Testplan: Voert tests uit vanuit uw testplan waaraan een geautomatiseerde testmethode is gekoppeld. Zie Automatische tests koppelen aan testcases voor meer informatie over het koppelen van tests aan een testcasewerkitem.
  • Testuitvoering: Gebruik deze optie wanneer u een omgeving instelt om tests uit te voeren vanuit testplannen. Deze optie mag niet worden gebruikt bij het uitvoeren van tests in een CI/CD-pijplijn (continue integratie/continue implementatie).

testAssemblyVer2 - Bestanden testen
string. Vereist wanneer testSelector = testAssemblies. Standaardwaarde: **\bin\**\*test.dll\n**\bin\**\*tests.dll.

Hiermee worden tests uitgevoerd vanuit de opgegeven bestanden. Geordende tests en webtests kunnen worden uitgevoerd door respectievelijk de .orderedtest bestanden en .webtest op te geven. Als u wilt uitvoeren .webtest, hebt u Visual Studio 2017 Update 4 of hoger nodig. De bestandspaden zijn relatief ten opzichte van de zoekmap. Deze invoer ondersteunt meerdere regels met minimatchpatronen.

# Example
- task: VSTest@2
  inputs:
    testSelector: 'testAssemblies'
    testAssemblyVer2: |
      **\*test*.dll
      !**\*TestAdapter.dll
      !**\obj\**

testAssemblyVer2 - Bestanden testen
string. Vereist wanneer testSelector = testAssemblies. Standaardwaarde: **\*test*.dll\n!**\*TestAdapter.dll\n!**\obj\**.

Hiermee worden tests uitgevoerd vanuit de opgegeven bestanden. Geordende tests en webtests kunnen worden uitgevoerd door respectievelijk de .orderedtest bestanden en .webtest op te geven. Als u wilt uitvoeren .webtest, hebt u Visual Studio 2017 Update 4 of hoger nodig. De bestandspaden zijn relatief ten opzichte van de zoekmap. Deze invoer ondersteunt meerdere regels met minimatchpatronen.

# Example
- task: VSTest@2
  inputs:
    testSelector: 'testAssemblies'
    testAssemblyVer2: |
      **\*test*.dll
      !**\*TestAdapter.dll
      !**\obj\**

testPlan - Testplan
string. Vereist wanneer testSelector = testPlan.

Hiermee geeft u een testplan op met testsuites met geautomatiseerde testcases.


testSuite - Testpakket
string. Vereist wanneer testSelector = testPlan.

Hiermee geeft u een of meer testsuites met geautomatiseerde testcases. Werkitems voor testcases moeten worden gekoppeld aan een geautomatiseerde testmethode.


testConfiguration - Configuratie testen
string. Vereist wanneer testSelector = testPlan.

Hiermee geeft u de testconfiguratie op.


tcmTestRun - Testuitvoering
string. Optioneel. Gebruik wanneer testSelector = testRun. Standaardwaarde: $(test.RunId).

Hiermee geeft u de selectie op basis van testuitvoering op die wordt gebruikt bij het activeren van geautomatiseerde testuitvoeringen vanuit testplannen. Deze optie kan niet worden gebruikt voor het uitvoeren van tests in de CI/CD-pijplijn.


searchFolder - Zoekmap
string. Vereist. Standaardwaarde: $(System.DefaultWorkingDirectory).

Hiermee geeft u de map te zoeken naar de testassembly's.


resultsFolder - Map met testresultaten
string. Standaardwaarde: $(Agent.TempDirectory)\TestResults.

Hiermee geeft u de map op om testresultaten op te slaan. Wanneer u de standaardmap gebruikt, wordt deze opgeschoond aan het einde van een pijplijnuitvoering. De map met resultaten wordt altijd aan het begin van de vstest taak opgeschoond voordat de tests worden uitgevoerd. Het relatieve mappad, indien opgegeven, wordt beschouwd als relatief ten opzichte van $(Agent.TempDirectory).


testFiltercriteria - Filtercriteria testen
string. Optioneel. Gebruik wanneer testSelector = testAssemblies.

Hiermee geeft u aanvullende criteria voor het filteren van tests van testassembly's. Bijvoorbeeld: Priority=1|Name=MyTestMethod. Meer informatie over opdrachtregelopties.


runOnlyImpactedTests - Alleen betrokken tests uitvoeren
boolean. Optioneel. Gebruik wanneer testSelector = testAssemblies. Standaardwaarde: False.

Hiermee geeft u automatisch de tests op die nodig zijn om de codewijziging te valideren en voert u deze uit. Meer informatie over het gebruik van Test Impact Analysis.


runAllTestsAfterXBuilds - Aantal builds waarna alle tests moeten worden uitgevoerd
string. Optioneel. Gebruik wanneer testSelector = testAssemblies && runOnlyImpactedTests = true. Standaardwaarde: 50.

Hiermee geeft u het aantal builds op dat moet worden uitgevoerd voordat alle tests automatisch worden uitgevoerd. Met Test Impact Analysis wordt de toewijzing tussen testcases en broncode opgeslagen. Het wordt aanbevolen om de toewijzing opnieuw te genereren door alle tests regelmatig uit te voeren.


uiTests - Testmix bevat UI-tests
boolean. Standaardwaarde: false.

Als u UI-tests wilt uitvoeren, moet u ervoor zorgen dat de agent is ingesteld om te worden uitgevoerd in de interactieve modus met Autologon ingeschakeld. Het instellen van een agent die interactief wordt uitgevoerd, moet worden uitgevoerd voordat u de build/release in de wachtrij zet. Als u dit selectievakje incheckt, wordt de agent niet automatisch in de interactieve modus geconfigureerd. Deze optie dient als herinnering om de agent op de juiste manier te configureren om fouten te voorkomen. Gehoste Windows-agents uit de VS 2015- en 2017-pools kunnen worden gebruikt om UI-tests uit te voeren.


vstestLocationMethod - Testplatform selecteren met behulp van
string. Toegestane waarden: version, location (Specifieke locatie). Standaardwaarde: version.

Hiermee geeft u op welk testplatform moet worden gebruikt.


vsTestVersion - Testplatformversie
string. Optioneel. Gebruik wanneer vstestLocationMethod = version. Toegestane waarden: latest, 17.0 (Visual Studio 2022), 16.0 (Visual Studio 2019), 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015), toolsInstaller (Geïnstalleerd door hulpprogramma's). Standaardwaarde: latest.

Hiermee geeft u de versie van Visual Studio Test te gebruiken. Als laatste is opgegeven, kiest deze invoer de meest recente versie (uit de lijst met toegestane waarden) die is geïnstalleerd. Als u tests wilt uitvoeren zonder Visual Studio op de agent, gebruikt u de installatieoptie Geïnstalleerd door hulpprogramma's . Zorg ervoor dat u de visual Studio Test Platform Installer-taak opneemt om het testplatform van NuGet te verkrijgen.


vsTestVersion - Testplatformversie
string. Optioneel. Gebruik wanneer vstestLocationMethod = version. Toegestane waarden: latest, 16.0 (Visual Studio 2019), 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015), toolsInstaller (Geïnstalleerd door hulpprogramma's). Standaardwaarde: latest.

Hiermee geeft u de versie van Visual Studio Test te gebruiken. Als laatste is opgegeven, kiest deze invoer de meest recente versie (uit de lijst met toegestane waarden) die is geïnstalleerd. Als u tests wilt uitvoeren zonder Visual Studio op de agent, gebruikt u de installatieoptie Geïnstalleerd door hulpprogramma's . Zorg ervoor dat u de visual Studio Test Platform Installer-taak opneemt om het testplatform van NuGet te verkrijgen.


vstestLocation - Pad naar vstest.console.exe
string. Optioneel. Gebruik wanneer vstestLocationMethod = location.

Hiermee geeft u het pad naar VSTest.


runSettingsFile - Instellingenbestand
string.

Hiermee geeft u het pad naar een runsettings of testsettings bestand te gebruiken met de tests. Gebruik voor Visual Studio 15.7 en hoger runsettings voor alle testtypen. Meer informatie over het converteren van een .testsettings bestand naar een .runsettings bestand.


overrideTestrunParameters - Testuitvoeringsparameters overschrijven
string.

Overschrijft de parameters die zijn gedefinieerd in de TestRunParameters sectie van een runsettings bestand of de Properties sectie van een testsettings bestand. Bijvoorbeeld: -key1 value1 -key2 value2. Opmerking: Eigenschappen die zijn opgegeven in een testsettings bestand, zijn toegankelijk via visual TestContext studio 2017 (update 4 of hoger).


pathtoCustomTestAdapters - Pad naar aangepaste testadapters
string.

Hiermee geeft u het pad naar aangepaste testadapters. Adapters die zich in dezelfde map bevinden als de testassembly's, worden automatisch gedetecteerd.


runInParallel - Tests parallel uitvoeren op machines met meerdere kernen
boolean. Standaardwaarde: False.

Als deze optie is ingesteld op true, worden de tests parallel uitgevoerd en wordt gebruikgemaakt van de beschikbare kernen van de machine. Hiermee wordt de MaxCpuCount overschreven als deze is opgegeven in uw runsettings bestand. Meer informatie over hoe tests parallel worden uitgevoerd.


runTestsInIsolation - Tests in isolatie uitvoeren
boolean. Standaardwaarde: False.

Voert de tests uit in een geïsoleerd proces. Dit leidt waarschijnlijk tot minder fouten in het vstest.console.exe testproces, maar tests worden mogelijk langzamer uitgevoerd. Deze optie kan momenteel niet worden gebruikt bij uitvoering met de taakinstelling voor meerdere agents.


codeCoverageEnabled - Codedekking ingeschakeld
boolean. Standaardwaarde: False.

Verzamelt informatie over codedekking van de testuitvoering.


otherConsoleOptions - Andere consoleopties
string.

Andere consoleopties die kunnen worden doorgegeven aan vstest.console.exe.

Deze opties worden niet ondersteund en worden genegeerd bij het uitvoeren van tests met behulp van de parallelle instelling voor meerdere agents van een agenttaak, bij het uitvoeren van tests met behulp van het testplan of de optie Testuitvoering , of wanneer een aangepaste batchverwerkingsoptie is geselecteerd. De opties kunnen in plaats daarvan worden opgegeven met behulp van een instellingenbestand.


distributionBatchType - Batchtests
string. Toegestane waarden: basedOnTestCases (Op basis van het aantal tests en agents), basedOnExecutionTime (gebaseerd op de voorbije uitvoeringstijd van tests), basedOnAssembly (gebaseerd op testassembly's). Standaardwaarde: basedOnTestCases.

Een batch is een groep tests. Een batch met tests voert de tests tegelijkertijd uit en de resultaten worden gepubliceerd voor de batch. Als de taak waarin de taak wordt uitgevoerd is ingesteld op het gebruik van meerdere agents, haalt elke agent alle beschikbare batches tests op om parallel uit te voeren. Een batch kan worden uitgevoerd:

op basis van het aantal tests en agents. Eenvoudige batchverwerking op basis van het aantal tests en agents dat deelneemt aan de testuitvoering.

op basis van de afgelopen uitvoeringstijd van tests. Deze batchverwerking houdt rekening met de afgelopen uitvoeringstijd om batches van tests te maken waarbij elke batch ongeveer dezelfde uitvoeringsduur heeft.

op basis van testassembly's. Tests van een assembly worden in batches uitgevoerd.


batchingBasedOnAgentsOption - Batch-opties
string. Optioneel. Gebruik wanneer distributionBatchType = basedOnTestCases. Toegestane waarden: autoBatchSize (Bepaal automatisch de batchgrootte) customBatchSize (Geef een batchgrootte op). Standaardwaarde: autoBatchSize.

Hiermee geeft u eenvoudige batchverwerking op basis van het aantal tests en agents dat deelneemt aan de testuitvoering. Wanneer de batchgrootte automatisch wordt bepaald, bevat (total number of tests / number of agents) elke batch tests. Als er een batchgrootte is opgegeven, bevat elke batch het opgegeven aantal tests.


customBatchSizeValue - Aantal tests per batch
string. Vereist wanneer distributionBatchType = basedOnTestCases && batchingBasedOnAgentsOption = customBatchSize. Standaardwaarde: 10.

Hiermee geeft u de batchgrootte op.


batchingBasedOnExecutionTimeOption - Batch-opties
string. Optioneel. Gebruik wanneer distributionBatchType = basedOnExecutionTime. Toegestane waarden: autoBatchSize (Bepaal automatisch de batchtijd) customTimeBatchSize (Geef de uitvoeringstijd per batch op). Standaardwaarde: autoBatchSize.

Deze batchverwerking houdt rekening met eerdere uitvoeringstijden om batches van tests te maken waarbij elke batch ongeveer dezelfde uitvoeringsduur heeft. Snel uitgevoerde tests worden samen in batches uitgevoerd, terwijl langer uitgevoerde tests tot een afzonderlijke batch kunnen behoren. Wanneer deze optie wordt gebruikt met de taakinstelling voor meerdere agents, wordt de totale testtijd tot een minimum beperkt.


customRunTimePerBatchValue - Uitvoeringstijd (sec) per batch
string. Vereist wanneer distributionBatchType = basedOnExecutionTime && batchingBasedOnExecutionTimeOption = customTimeBatchSize. Standaardwaarde: 60.

Hiermee geeft u de uitvoeringsduur (in seconden) per batch op.


dontDistribute - Tests repliceren in plaats van te distribueren wanneer meerdere agents in de taak worden gebruikt
boolean. Standaardwaarde: False.

Als u deze optie kiest, worden tests niet verdeeld over agents wanneer de taak wordt uitgevoerd in een taak met meerdere agents. Elk van de geselecteerde test(en) wordt herhaald op elke agent. Deze optie is niet van toepassing wanneer de agenttaak is geconfigureerd voor uitvoering zonder parallelle uitvoering of met de optie voor meervoudige configuratie.


dontDistribute - Distribueer geen tests en repliceer in plaats daarvan niet wanneer meerdere agents in de taak worden gebruikt
boolean. Standaardwaarde: False.

Als u deze optie kiest, worden tests niet verdeeld over agents wanneer de taak wordt uitgevoerd in een taak met meerdere agents. Elk van de geselecteerde test(en) wordt herhaald op elke agent. Deze optie is niet van toepassing wanneer de agenttaak is geconfigureerd voor uitvoering zonder parallelle uitvoering of met de optie voor meervoudige configuratie.


testRunTitle - Titel van testuitvoering
string.

Hiermee geeft u een naam voor de testuitvoering.


platform - Platform bouwen
string.

Hiermee geeft u het buildplatform op waarop de tests moeten worden gerapporteerd. Als u in uw buildtaak een variabele voor het platform hebt gedefinieerd, gebruikt u die met deze invoer.


configuration - Buildconfiguratie
string.

Hiermee geeft u de buildconfiguratie op waarvoor de tests moeten worden gerapporteerd. Als u een variabele voor configuratie hebt gedefinieerd in uw buildtaak, gebruikt u die met deze invoer.


publishRunAttachments - Testbijlagen uploaden
boolean. Standaardwaarde: true.

Hiermee wordt u in- of uitgeschakeld voor bijlagen op het niveau van de publicatieuitvoering.


failOnMinTestsNotRun - Mislukt de taak als er geen minimaal aantal tests wordt uitgevoerd.
boolean. Standaardwaarde: False.

De taak mislukt als er geen minimaal aantal tests wordt uitgevoerd. Dit kan handig zijn als wijzigingen in taakinvoer of onderliggende afhankelijkheden van de testadapter ertoe leiden dat slechts een subset van de gewenste tests wordt gevonden.


minimumExpectedTests - Minimumaantal tests
string. Optioneel. Gebruik wanneer failOnMinTestsNotRun = true. Standaardwaarde: 1.

Hiermee geeft u het minimale aantal tests dat moet worden uitgevoerd om de taak te voltooien. Het totale aantal uitgevoerde tests wordt berekend als de som van geslaagde, mislukte en afgebroken tests.


diagnosticsEnabled - Geavanceerde diagnostische gegevens verzamelen in het geval van onherstelbare fouten
boolean. Standaardwaarde: false.

Verzamelt diagnostische gegevens om onherstelbare fouten, zoals een testcrash, op te lossen. Wanneer deze optie is ingeschakeld, wordt er een reeks-XML-bestand gegenereerd en aan de testuitvoering gekoppeld. Het sequentiebestand bevat informatie over de volgorde waarin de tests zijn uitgevoerd, zodat een mogelijke schuldige test kan worden geïdentificeerd.


diagnosticsEnabled - Geavanceerde diagnostische gegevens verzamelen in het geval van onherstelbare fouten
boolean. Standaardwaarde: True.

Verzamelt diagnostische gegevens om onherstelbare fouten, zoals een testcrash, op te lossen. Wanneer deze optie is ingeschakeld, wordt er een reeks-XML-bestand gegenereerd en aan de testuitvoering gekoppeld. Het sequentiebestand bevat informatie over de volgorde waarin de tests zijn uitgevoerd, zodat een mogelijke schuldige test kan worden geïdentificeerd.


collectDumpOn - Procesdump verzamelen en koppelen aan testuitvoeringsrapport
string. Optioneel. Gebruik wanneer diagnosticsEnabled = true. Toegestane waarden: onAbortOnly (Alleen bij afbreken), always, never. Standaardwaarde: onAbortOnly.

Verzamelt een minidump die kan worden gebruikt voor verdere analyse.

  • onAbortOnly : er wordt alleen een minidump verzameld wanneer de testuitvoering wordt afgebroken.
  • Altijd : er wordt altijd een minidump verzameld, ongeacht of de testuitvoering is voltooid of niet.
  • Nooit : er wordt geen minidump verzameld, ongeacht of de testuitvoering is voltooid of niet.

rerunFailedTests - Mislukte tests opnieuw uitvoeren
boolean. Standaardwaarde: False.

Voert mislukte tests opnieuw uit totdat ze zijn geslaagd of totdat het maximum aantal pogingen is bereikt.


rerunType - Niet opnieuw uitvoeren als testfouten de opgegeven drempelwaarde overschrijden
string. Optioneel. Gebruik wanneer rerunFailedTests = true. Toegestane waarden: basedOnTestFailurePercentage (% fout), basedOnTestFailureCount (# van mislukte tests). Standaardwaarde: basedOnTestFailurePercentage.

Hiermee voorkomt u dat tests opnieuw worden uitgevoerd wanneer het aantal fouten de opgegeven drempelwaarde overschrijdt. Dit is van toepassing als omgevingsproblemen leiden tot enorme fouten. U kunt het percentage fouten of het aantal mislukte tests opgeven als drempelwaarde.


rerunFailedThreshold - % fout
string. Optioneel. Gebruik wanneer rerunFailedTests = true && rerunType = basedOnTestFailurePercentage. Standaardwaarde: 30.

Hiermee voorkomt u dat tests opnieuw worden uitgevoerd wanneer het percentage mislukte testcases de opgegeven drempelwaarde overschrijdt. Dit is van toepassing als omgevingsproblemen leiden tot enorme fouten.


rerunFailedTestCasesMaxLimit - Aantal mislukte tests
string. Optioneel. Gebruik wanneer rerunFailedTests = true && rerunType = basedOnTestFailureCount. Standaardwaarde: 5.

Vermijdt het opnieuw uitvoeren van tests wanneer het aantal mislukte testcases de opgegeven limiet overschrijdt. Dit is van toepassing als omgevingsproblemen leiden tot enorme fouten.


rerunMaxAttempts - Maximum aantal pogingen
string. Optioneel. Gebruik wanneer rerunFailedTests = true. Standaardwaarde: 3.

Hiermee geeft u het maximum aantal keren dat een mislukte test opnieuw moet worden geprobeerd. Als een test slaagt voordat het maximum aantal pogingen is bereikt, wordt deze niet opnieuw uitgevoerd.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om eenheids- en functionele tests (Selenium, Appium, Coded UI-test en meer) uit te voeren met behulp van de Visual Studio Test-runner. Naast op MSTest gebaseerde tests kunnen testframeworks met een Visual Studio-testadapter ook worden uitgevoerd, zoals xUnit, NUnit of Chutzpah.

Test of het .NET Core-doelframework kan worden uitgevoerd door de juiste waarde voor het doelframework op te geven in het .runsettings-bestand.

Tests kunnen worden gedistribueerd op meerdere agents met behulp van versie 2 van deze taak. Zie Tests parallel uitvoeren met behulp van de Visual Studio-testtaak voor meer informatie.

Vereisten controleren

Als u een zelf-hostende Windows-agent gebruikt, moet deze vereiste zijn geïnstalleerd:

Eisen

De agent moet de volgende mogelijkheid hebben:

vstest

Aan de vraag vs. kan op twee manieren worden voldaan:

  1. Visual Studio is geïnstalleerd op de agentcomputer.
  2. Met behulp van de Visual Studio Test Platform Installer-taak in de pijplijndefinitie.

Hoe kan ik tests uitvoeren die TestCase als gegevensbron gebruiken?

Als u geautomatiseerde tests wilt uitvoeren die TestCase als gegevensbron gebruiken, hebt u het volgende nodig:

  1. Visual Studio 2017.6 of hoger moet zijn geïnstalleerd op de agentcomputer. De visual Studio Test Platform Installer-taak kan niet worden gebruikt om tests uit te voeren die TestCase als gegevensbron gebruiken.
  2. Creatie een PAT die is geautoriseerd voor het bereik 'Werkitems (volledig)'.
  3. Voeg een beveiligde build- of releasevariabele toe met de naam Test.TestCaseAccessToken met de waarde die is ingesteld op de PAT die in de vorige stap is gemaakt.

Ik ondervind problemen bij het uitvoeren van gegevensgestuurde xUnit- en NUnit-tests met een aantal taakopties. Zijn er bekende beperkingen?

Gegevensgestuurde tests die gebruikmaken van xUnit- en NUnit-testframeworks hebben enkele bekende beperkingen en kunnen niet worden gebruikt met de volgende taakopties:

  1. Voer mislukte tests opnieuw uit.
  2. Het distribueren van tests op meerdere agents en batchopties.
  3. Impactanalyse testen.

De bovenstaande beperkingen worden veroorzaakt door de wijze waarop de adapters voor deze testframeworks gegevensgestuurde tests detecteren en rapporteren.

Ondersteunt de VSTest-taak het uitvoeren van tests die zijn gericht op meerdere doelframeworks tegelijk?

Ja, vanaf versie 17.3 VSTest biedt ondersteuning voor het uitvoeren van tests die zijn gericht op meerdere doelframeworks tegelijk. Voorheen was dit niet mogelijk vanwege een beperking van de VSTest-platformzijde .

Als u tests wilt uitvoeren die deel uitmaken van meerdere doelframeworks, moet u een compatibele versie van VSTest installeren via visual Studio Test Platform Installer en instellen vsTestVersion op toolsInstaller het gebruik ervan.

Tijdens het publiceren van het testresultaat wordt deze fout weergegeven: Kan testresultaten niet publiceren: Ongeldige prioriteit opgegeven?

Deze fout treedt op als voor een van de testmethoden een prioriteit is ingesteld boven 255, de prioriteit van de testmethode in de code wordt opgelost en de tests opnieuw worden uitgevoerd. U kunt het gegenereerde trx-bestand bekijken om alle tests te zien met een hogere prioriteit dan 255.

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: vstest
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 2.103.0 of hoger
Taakcategorie Testen