Skip to content

Latest commit

 

History

History
67 lines (46 loc) · 2.99 KB

microsoft-testing-platform-retry.md

File metadata and controls

67 lines (46 loc) · 2.99 KB
title description author ms.author ms.date ai-usage
Microsoft.Testing.Platform retry
Learn about retrying failed tests with Microsoft.Testing.Platform.
evangelink
amauryleve
02/25/2026
ai-assisted

Retry

This feature requires the Microsoft.Testing.Extensions.Retry NuGet package.

Tip

When using Microsoft.Testing.Platform.MSBuild (included transitively by MSTest, NUnit, and xUnit runners), this extension is auto-registered when you install its NuGet package — no code changes needed. The manual registration in the following section is only required if you disabled the auto-generated entry point by setting <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Manual registration

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddRetryProvider();

Retry

A .NET test resilience and transient-fault-handling extension.

This extension is intended for integration tests where the test depends heavily on the state of the environment and could experience transient faults.

Note

The package is shipped with the restrictive Microsoft.Testing.Platform Tools license. The full license is available at https://www.nuget.org/packages/Microsoft.Testing.Extensions.Retry/1.0.0/License.

Options

Option Description
--retry-failed-tests Reruns any failed tests until they pass or until the maximum number of attempts is reached. Required to activate the extension.
--retry-failed-tests-max-percentage Avoids rerunning tests when the percentage of failed test cases crosses the specified threshold. Can't be combined with --retry-failed-tests-max-tests.
--retry-failed-tests-max-tests Avoids rerunning tests when the number of failed test cases crosses the specified limit. Can't be combined with --retry-failed-tests-max-percentage.

Both threshold options (--retry-failed-tests-max-percentage and --retry-failed-tests-max-tests) require --retry-failed-tests to also be set.

Examples

Retry failed tests up to 3 times:

dotnet run --project Contoso.MyTests -- --retry-failed-tests 3

Retry failed tests up to 2 times, but stop retrying if more than 50% of tests failed:

dotnet run --project Contoso.MyTests -- --retry-failed-tests 2 --retry-failed-tests-max-percentage 50

Retry failed tests up to 3 times, but stop retrying if more than 10 tests failed:

dotnet run --project Contoso.MyTests -- --retry-failed-tests 3 --retry-failed-tests-max-tests 10

Limitations

  • Not supported on browser platforms.
  • Not supported in hot reload mode.