選択した単体テストの実行

MSTest の例

using Microsoft.VisualStudio.TestTools.UnitTesting;

namespace MSTestNamespace
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod, Priority(1), TestCategory("CategoryA")]
        public void TestMethod1()
        {
        }

        [TestMethod, Priority(2)]
        public void TestMethod2()
        {
        }
    }
}

Id フィルター処理には MSTest.TestAdapter 3.6 以降が必要です。 VSTest 検出が TestCase.Idで返すテスト ケースから GUID を取得します。 このフィルターでは、表示名を一致させたりエスケープしたりすることなく、展開されたデータドリブンイテレーションを 1 つ選択できます。 各行は、個々のテスト ケースとして検出する必要があります。フォールド データ ドリブン テストでは、親 ID が 1 つだけ公開されます。

条件演算子 | と & の使用例:

• UnitTest1 に FullyQualifiedName が含まれるか、または、TestCategoryAttribute が "CategoryA" であるテストを実行するには。

  dotnet test --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"
  

• UnitTest1 に FullyQualifiedName が含まれ、かつ、TestCategoryAttribute が "CategoryA" であるテストを実行するには。

  dotnet test --filter "FullyQualifiedName~UnitTest1&TestCategory=CategoryA"
  

• FullyQualifiedName に UnitTest1 が含まれ、かつ、TestCategoryAttribute が "CategoryA" であるか、または、PriorityAttribute の優先順位が 1 であるテストを実行するには。

  dotnet test --filter "(FullyQualifiedName~UnitTest1&TestCategory=CategoryA)|Priority=1"
  

xUnit の例

using Xunit;

namespace XUnitNamespace
{
    public class TestClass1
    {
        [Fact, Trait("Priority", "1"), Trait("Category", "CategoryA")]
        public void Test1()
        {
        }

        [Fact, Trait("Priority", "2")]
        public void Test2()
        {
        }
    }
}

コード例では、特性をキー "Category" や "Priority" で定義すると、フィルター処理に使用できます。

条件演算子 | と & の使用例:

• TestClass1 に FullyQualifiedName が含まれるか、または、Trait のキーが "Category" で値が "CategoryA" であるテストを実行するには。

  dotnet test --filter "FullyQualifiedName~TestClass1|Category=CategoryA"
  

• TestClass1 に FullyQualifiedName が含まれ、かつ、Trait のキーが "Category" で値が "CategoryA" であるテストを実行するには。

  dotnet test --filter "FullyQualifiedName~TestClass1&Category=CategoryA"
  

• FullyQualifiedName に TestClass1 が含まれ、かつ、Trait のキーが "Category" で値が "CategoryA" であるか、または、Trait のキーが "Priority" で値が 1 であるテストを実行するには。

  dotnet test --filter "(FullyQualifiedName~TestClass1&Category=CategoryA)|Priority=1"
  

NUnit の例

NUnit の場合、 TestCategory と Category は交換可能なフィルター プロパティ名です。 どちらの場合も、 Category 属性で割り当てたカテゴリをフィルター処理するため、 --filter Category=MyCategory を使用する既存の NUnit コマンドを変更する必要はありません。

using NUnit.Framework;

namespace NUnitNamespace
{
    public class UnitTest1
    {
        [Test, Property("Priority", 1), Category("CategoryA")]
        public void TestMethod1()
        {
        }

        [Test, Property("Priority", 2)]
        public void TestMethod2()
        {
        }
    }
}

条件演算子 | と & の使用例:

UnitTest1 に FullyQualifiedName が含まれるか、または、Category が "CategoryA" であるテストを実行するには。

dotnet test --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"

UnitTest1 に FullyQualifiedName が含まれ、かつ、Category が "CategoryA" であるテストを実行するには。

dotnet test --filter "FullyQualifiedName~UnitTest1&TestCategory=CategoryA"

FullyQualifiedName に UnitTest1 が含まれ、かつ、Category が "CategoryA" であるか、または、Property の "Priority" が 1 であるテストを実行するには。

dotnet test --filter "(FullyQualifiedName~UnitTest1&TestCategory=CategoryA)|Priority=1"

詳細については、TestCase フィルターに関するページを参照してください。

TUnit の例

TUnit では、この記事で前述した --filter オプションはサポートされていません。 代わりに、MTP --treenode-filter オプションが使用されます。 ツリー ノード フィルターは、 /<Assembly>/<Namespace>/<Class>/<Method>形式のパスであり、次のようになります。

• * は 1 つのパス セグメント内の任意の値と一致し、 *Method*などの他のテキストと組み合わせることができます。
• ** は、任意の数のパス セグメントと一致します。
• [<Property>=<Value>] パス セグメントの後に、そのプロパティを持つテストが一致します。 [Category("CategoryA")]はプロパティ Categoryとして公開され、プロパティ Priorityとして[Property("Priority", "2")]されます。
• | (または) と & (および) は、1 つのパス セグメントまたはプロパティ フィルター内で代替候補を結合します。 /*/*/(UnitTest1)|(UnitTest2)/*や[(Category=CategoryA)|(Priority=2)]など、各代替候補をかっこで囲みます。

--treenode-filter オプションは MTP オプションであるため、dotnet testは MTP モードで実行する必要があります。 .NET 10 SDK 以降を使用して、ソリューション ルートの global.json ファイルに次の構成を追加します。

{
    "test": {
        "runner": "Microsoft.Testing.Platform"
    }
}

これを使用しない場合、 dotnet test は VSTest モードで実行され、テストを実行する前に MSB1001: Unknown switch で失敗します。 以前の SDK で MTP プロジェクトを実行する方法など、詳細については、 dotnet テストの MTP モードを参照してください。

この例では、次のテスト クラスを使用します。

namespace TUnitNamespace;

public class UnitTest1
{
    [Test, Property("Priority", "1"), Category("CategoryA")]
    public void TestMethod1()
    {
    }

    [Test, Property("Priority", "2")]
    public void TestMethod2()
    {
    }
}

条件演算子 | と & の使用例:

クラス UnitTest1に含まれるテストを実行し、"CategoryA"のCategoryを持つ場合:

dotnet test --treenode-filter "/*/*/UnitTest1/*[Category=CategoryA]"

"CategoryA"または"2"のPriorityのCategoryを持つテストを実行するには:

dotnet test --treenode-filter "/**[(Category=CategoryA)|(Priority=2)]"

クラス UnitTest1に含まれるテストを実行するには、"CategoryA"のCategoryまたは"2"のPriorityを使用します。

dotnet test --treenode-filter "/*/*/UnitTest1/*[(Category=CategoryA)|(Priority=2)]"

"CategoryA"のCategoryと"1"のPriorityを持つテストを実行するには:

dotnet test --treenode-filter "/**[(Category=CategoryA)&(Priority=1)]"