Konfigurera MSTest

MSTest, Microsoft Testing Framework, är ett testramverk för .NET-program. Det gör att du kan skriva och köra tester och tillhandahålla testpaket med integrering till Visual Studio och Visual Studio Code Test Explorers, .NET CLI och många CI-pipelines.

MSTest är ett fullständigt stöd, öppen källkod och ett plattformsoberoende testramverk som fungerar med alla .NET-mål som stöds (.NET Framework, .NET Core, .NET, UWP, WinUI och så vidare) som finns på GitHub.

Körinställningar

En .runsettings-fil kan användas för att konfigurera hur enhetstester körs. Om du vill veta mer om körinställningar och konfigurationer som är relaterade till plattformen kan du läsa dokumentationen om VSTest-körinställningar eller dokumentationen om MSTest runner körinställningar.

MSTest-element

Med följande runsettings-poster kan du konfigurera hur MSTest fungerar.

Tidsgränsvärden måste vara positiva heltal i millisekunder. Om du vill köra utan tidsgräns utelämnar du posten i stället för att ställa in den på 0. Globala tidsgränser för testfixtur ärver motsvarande TestInitializeTimeout eller TestCleanupTimeout värde.

TestRunParameter komponent

<TestRunParameters>
    <Parameter name="webAppUrl" value="http://localhost" />
</TestRunParameters>

Testkörningsparametrar är ett sätt att definiera variabler och värden som är tillgängliga för testerna vid körning. Få åtkomst till parametrarna med egenskapen MSTest TestContext.Properties :

private string _appUrl;
public TestContext TestContext { get; set; }

[TestMethod]
public void HomePageTest()
{
    string _appUrl = TestContext.Properties["webAppUrl"];
}

Om du vill använda testkörningsparametrar lägger du till en offentlig TestContext egenskap i testklassen.

Exempel på .runsettings-fil

Följande XML visar innehållet i en typisk .runsettings-fil . Kopiera den här koden och redigera den så att den passar dina behov.

Varje element i filen är valfritt eftersom det har ett standardvärde.

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>

  <!-- Parameters used by tests at runtime -->
  <TestRunParameters>
    <Parameter name="webAppUrl" value="http://localhost" />
    <Parameter name="webAppUserName" value="Admin" />
    <Parameter name="webAppPassword" value="Password" />
  </TestRunParameters>

  <!-- MSTest -->
  <MSTest>
    <MapInconclusiveToFailed>True</MapInconclusiveToFailed>
    <CaptureTraceOutput>false</CaptureTraceOutput>
    <DeleteDeploymentDirectoryAfterTestRunIsComplete>False</DeleteDeploymentDirectoryAfterTestRunIsComplete>
    <DeploymentEnabled>False</DeploymentEnabled>
    <ConsiderFixturesAsSpecialTests>False</ConsiderFixturesAsSpecialTests>
    <AssemblyResolution>
      <Directory path="D:\myfolder\bin\" includeSubDirectories="false"/>
    </AssemblyResolution>
  </MSTest>

</RunSettings>

testconfig.json

När du kör testerna med MSTest kan du använda en testconfig.json-fil för att konfigurera testkörarnas beteende. Den testconfig.json filen är en JSON-fil som innehåller konfigurationsinställningarna för testlöparen. Filen används för att konfigurera testlöparen och testkörningsmiljön. Mer information finns i MTP-testconfig.json dokumentation.

Från och med MSTest 3.7 kan du även konfigurera MSTest-körningar i samma konfigurationsfil. I följande avsnitt beskrivs de inställningar som du kan använda i filen testconfig.json.

Från och med MSTest 4.3.3 accepterar .NET Framework även kommentarer och avslutande kommatecken i testconfig.json.

MSTest-element

MSTest-inställningarna grupperas efter funktioner som beskrivs i de avsnitt som följer.

assemblyResolution -inställningar

Alla inställningar i det här avsnittet tillhör elementet assemblyResolution.

Exempel:

{
  "mstest": {
    "assemblyResolution": {
        { "path": "...", "includeSubDirectories": "true/false" }
    }
  }
}

deployment -inställningar

Alla inställningar i det här avsnittet tillhör elementet deployment.

Exempel:

{
  "mstest": {
    "deployment": {
        "deleteDeploymentDirectoryAfterTestRunIsComplete": true,
        "deployTestSourceDependencies": true,
        "enabled": true
    }
  }
}

output -inställningar

Alla inställningar i det här avsnittet tillhör elementet output.

Exempel:

{
  "mstest": {
    "output": {
        "captureTrace": false
    }
  }
}

parallelism -inställningar

Alla inställningar i det här avsnittet tillhör elementet parallelism.

Exempel:

{
  "mstest": {
    "parallelism": {
        "enabled": true,
        "scope": "method",
        "workers": 32
    }
  }
}

execution -inställningar

Alla inställningar i det här avsnittet tillhör elementet execution.

Exempel:

{
  "mstest": {
    "execution": {
        "considerEmptyDataSourceAsInconclusive": false,
        "considerFixturesAsSpecialTests": false,
        "mapInconclusiveToFailed": true,
        "mapNotRunnableToFailed": true,
        "treatClassAndAssemblyCleanupWarningsAsErrors": false,
        "treatDiscoveryWarningsAsErrors": false
    }
  }
}

timeout -inställningar

Alla inställningar i det här avsnittet tillhör elementet timeout.

Exempel:

{
  "mstest": {
    "timeout": { "globalTestInitialize": 30000, "globalTestCleanup": 30000 }
  }
}

Exempel på testconfig.json fil

Följande JSON visar innehållet i en typisk .testconfig.json fil. Kopiera den här koden och redigera den så att den passar dina behov.

Varje element i filen är valfritt eftersom det har ett standardvärde.

{
  "platformOptions": {
    "resultDirectory": "./TestResults"
  },
  "mstest": {
    "execution": {
        "mapInconclusiveToFailed": true,
        "disableAppDomain": true,
        "considerFixturesAsSpecialTests": false
    },
    "parallelism": {
        "enabled": true,
        "scope": "method"
    },
    "output": {
        "captureTrace": false
    }
  }
}

MSBuild-egenskaper

Från och med MSTest 4.3 kan du välja parallellisering på sammansättningsnivå från projektfilen eller Directory.Build.props utan att skapa ett [assembly: Parallelize] attribut. Dessa egenskaper genererar motsvarande sammansättningsattribut under bygget, så de måste GenerateAssemblyInfo vara true (standardvärdet för SDK-liknande projekt).

MSTest validerar båda egenskaperna under bygget. Ogiltiga omfångsvärden, antal icke-heltalsarbetare och ett antal arbetare i kombination med ett None omfång misslyckas. Deklarera [assembly: Parallelize] inte heller eller [assembly: DoNotParallelize] i källan eftersom det genererade attributet duplicerar det. När GenerateAssemblyInfo är falsedeklarerar du attributet i källan i stället.

I följande exempel möjliggörs parallellisering på metodnivå med fyra arbetare för varje testprojekt som importerar Directory.Build.props filen:

<Project>
  <PropertyGroup>
    <MSTestParallelizeScope>MethodLevel</MSTestParallelizeScope>
    <MSTestParallelizeWorkers>4</MSTestParallelizeWorkers>
  </PropertyGroup>
</Project>