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 runner Visual Studio Test (VSTest). U kunt testframeworks uitvoeren die een Visual Studio-testadapter hebben. 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 (versie 2).

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.

Voert tests uit van 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\**.

Voert tests uit van 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 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 de 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 - Search map
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 worden automatisch de tests opgegeven en uitgevoerd die nodig zijn om de codewijziging te valideren. 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 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 om interactief te worden 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
string. Toegestane waarden: version, location (Specifieke locatie). Standaardwaarde: version.

Hiermee geeft u op welk testplatform moet worden gebruikt.


vsTestVersion - Platformversie testen
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-installatieprogramma). 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 - Platformversie testen
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 installer). 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 bestand of testsettings 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 mappad 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 tests parallel uitgevoerd en wordt gebruikgemaakt van de beschikbare kernen van de machine. Hiermee wordt de MaxCpuCount overschreven als deze is opgegeven in het 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 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 afgelopen uitvoeringsduur 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 te worden uitgevoerd. 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 uitvoering van de tests. Deze batchverwerking houdt rekening met de afgelopen uitvoeringstijd om batches tests te maken waarbij elke batch ongeveer dezelfde uitvoeringsduur heeft.

gebaseerd op testassembly's. Tests van een assembly worden in batches samengevoegd.


batchingBasedOnAgentsOption - Batch-opties
string. Optioneel. Gebruik wanneer distributionBatchType = basedOnTestCases. Toegestane waarden: autoBatchSize (Automatisch de batchgrootte bepalen), 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 gelijke uitvoeringstijd heeft. Snel uitgevoerde tests worden in batches samen uitgevoerd, terwijl langer lopende 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 - Duur (sec) per batch
string. Vereist wanneer distributionBatchType = basedOnExecutionTime && batchingBasedOnExecutionTimeOption = customTimeBatchSize. Standaardwaarde: 60.

Hiermee geeft u de actieve tijd (in seconden) per batch.


dontDistribute - Tests repliceren in plaats van te distribueren wanneer meerdere agents worden gebruikt in de taak
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 om zonder parallelle uitvoering of met de optie voor meerdere configuraties te worden uitgevoerd.


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 om zonder parallelle uitvoering of met de optie voor meerdere configuraties te worden uitgevoerd.


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 tegen welke 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 kunt u zich afmelden voor het publiceren van bijlagen op uitvoeringsniveau.


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

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


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

Hiermee geeft u het minimale aantal tests dat moet worden uitgevoerd om de taak te laten slagen. 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 catastrofale fouten
boolean. Standaardwaarde: false.

Verzamelt diagnostische gegevens om onherstelbare fouten, zoals een testcrash, op te lossen. Wanneer deze optie is ingeschakeld, wordt een XML-reeksbestand gegenereerd en gekoppeld aan de testuitvoering. 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 catastrofale fouten
boolean. Standaardwaarde: True.

Verzamelt diagnostische gegevens om onherstelbare fouten, zoals een testcrash, op te lossen. Wanneer deze optie is ingeschakeld, wordt een XML-reeksbestand gegenereerd en gekoppeld aan de testuitvoering. 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 : een minidump wordt alleen 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 - Voer niet opnieuw uit als testfouten de opgegeven drempelwaarde overschrijden
string. Optioneel. Gebruik wanneer rerunFailedTests = true. Toegestane waarden: basedOnTestFailurePercentage (% mislukt), 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.

Hiermee voorkomt u dat tests opnieuw worden uitgevoerd 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 uitgevoerd. Als een test is geslaagd voordat het maximum aantal pogingen is bereikt, wordt deze niet opnieuw uitgevoerd.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties 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 Testrunner van Visual Studio. Naast tests op basis van MSTest kunnen ook testframeworks met een Visual Studio-testadapter 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 Test-taak 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 mogelijkheden hebben:

vstest

De vstest-vraag 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-installatietaak kan niet worden gebruikt om tests uit te voeren die TestCase als gegevensbron gebruiken.
  2. Maak een PAT die is geautoriseerd voor het bereik 'Werkitems (volledig)'.
  3. Voeg een beveiligde build- of releasevariabele met de naam Test.TestCaseAccessToken toe met de waarde 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.

Biedt de taak VSTest ondersteuning voor 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 om deze te gebruiken.

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 met een hogere prioriteit dan 255 te zien.

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