リトライ

この機能には、 Microsoft.Testing.Extensions.Retry NuGet パッケージが必要です。

ヒント

Microsoft.Testing.Platform.MSBuild (MSTest、NUnit、xUnit ランナーによって推移的に含まれる) を使用する場合、この拡張機能は NuGet パッケージをインストールするときに自動的に登録されます。コードの変更は必要ありません。 次のセクションの手動登録は、 <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>設定して自動生成されたエントリ ポイントを無効にした場合にのみ必要です。

手動登録

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

リトライ

.NET テストの回復性と一時的な障害処理拡張機能。

この拡張機能は、テストが環境の状態に大きく依存し、一時的な障害が発生する可能性がある統合テストを対象としています。

注

パッケージには、制限付きの Microsoft.Testing.Platform Tools ライセンスが付属しています。 完全なライセンスは、https://www.nuget.org/packages/Microsoft.Testing.Extensions.Retry/1.0.0/Licenseで入手できます。

オプション

Option	[説明]
--retry-failed-tests	失敗したテストが成功するまで、または試行の最大数に達するまで再実行します。 拡張機能をアクティブ化するために必要です。
--retry-failed-tests-max-percentage	失敗したテスト ケースの割合が指定したしきい値を超えた場合に、テストの再実行を回避します。 --retry-failed-tests-max-testsと組み合わせることはできません。
--retry-failed-tests-max-tests	失敗したテスト ケースの数が指定した制限を超えた場合に、テストの再実行を回避します。 --retry-failed-tests-max-percentageと組み合わせることはできません。

しきい値オプション (--retry-failed-tests-max-percentage と --retry-failed-tests-max-tests) の両方で、 --retry-failed-tests も設定する必要があります。

例示

失敗したテストを最大 3 回再試行します。

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

失敗したテストを最大 2 回再試行しますが、50% を超えるテストが失敗した場合は再試行を停止します。

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

失敗したテストを最大 3 回再試行しますが、10 を超えるテストが失敗した場合は再試行を停止します。

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

制限事項

• ブラウザー プラットフォームではサポートされていません。
• ホット リロード モードではサポートされていません。