运行选择性单元测试Running selective unit tests

本文内容

借助 .NET Core 中的 dotnet test 命令，可以使用筛选表达式来运行选择性测试。本文演示如何筛选运行哪些测试。下面的示例使用 dotnet test。如果使用的是 vstest.console.exe，请将 —filter 替换成 —testcasefilter:。

MSTestMSTest

using Microsoft.VisualStudio.TestTools.UnitTesting;
namespace MSTestNamespace
{
    [TestClass]
    public class UnitTest1
    {
        [TestCategory("CategoryA")]
        [Priority(1)]
        [TestMethod]
        public void TestMethod1()
        {
        }
        [Priority(2)]
        [TestMethod]
        public void TestMethod2()
        {
        }
    }
}

表达式	结果
`dotnet test —filter Method`	运行 `FullyQualifiedName` 包含 `Method` 的测试。在 `vstest 15.1+` 中可用。
`dotnet test —filter Name~TestMethod1`	运行名称包含 `TestMethod1` 的测试。
`dotnet test —filter ClassName=MSTestNamespace.UnitTest1`	运行属于类 `MSTestNamespace.UnitTest1` 的测试。注意：由于 `ClassName` 值应有命名空间，因此 `ClassName=UnitTest1` 无效。
`dotnet test —filter FullyQualifiedName!=MSTestNamespace.UnitTest1.TestMethod1`	运行除 `MSTestNamespace.UnitTest1.TestMethod1` 之外的其他所有测试。
`dotnet test —filter TestCategory=CategoryA`	运行含 `[TestCategory("CategoryA")]` 批注的测试。
`dotnet test —filter Priority=2`	运行含 `[Priority(2)]` 批注的测试。

使用条件运算符 | 和 &

表达式	结果
`dotnet test —filter "FullyQualifiedName~UnitTest1\|TestCategory=CategoryA"`	运行 `FullyQualifiedName` 包含 `UnitTest1` 或 `TestCategory` 是 `CategoryA` 的测试。
`dotnet test —filter "FullyQualifiedName~UnitTest1&TestCategory=CategoryA"`	运行 `FullyQualifiedName` 包含 `UnitTest1` 且 `TestCategory` 是 `CategoryA` 的测试。
`dotnet test —filter "(FullyQualifiedName~UnitTest1&TestCategory=CategoryA)\|Priority=1"`	运行 `FullyQualifiedName` 包含 `UnitTest1` 且 `TestCategory` 是 `CategoryA` 或 `Priority` 是 1 的测试。

xUnitxUnit

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

表达式	结果
`dotnet test —filter DisplayName=XUnitNamespace.TestClass1.Test1`	仅运行一个测试，即 `XUnitNamespace.TestClass1.Test1`。
`dotnet test —filter FullyQualifiedName!=XUnitNamespace.TestClass1.Test1`	运行除 `XUnitNamespace.TestClass1.Test1` 之外的其他所有测试。
`dotnet test —filter DisplayName~TestClass1`	运行显示名称包含 `TestClass1` 的测试。

在代码示例中，包含键 Category 和 Priority 的已定义特征可用于筛选。

表达式	结果
`dotnet test —filter XUnit`	运行 `FullyQualifiedName` 包含 `XUnit` 的测试。在 `vstest 15.1+` 中可用。
`dotnet test —filter Category=CategoryA`	运行包含 `[Trait("Category", "CategoryA")]` 的测试。

使用条件运算符 | 和 &

表达式	结果
`dotnet test —filter "FullyQualifiedName~TestClass1\|Category=CategoryA"`	运行 `FullyQualifiedName` 包含 `TestClass1` 或 `Category`是 `CategoryA` 的测试。
`dotnet test —filter "FullyQualifiedName~TestClass1&Category=CategoryA"`	运行 `FullyQualifiedName` 包含 `TestClass1` 且 `Category`是 `CategoryA` 的测试。
`dotnet test —filter "(FullyQualifiedName~TestClass1&Category=CategoryA)\|Priority=1"`	运行 `FullyQualifiedName` 包含 `TestClass1` 且 `Category` 是 `CategoryA` 或 `Priority` 是 1 的测试。

NUnitNUnit

using NUnit.Framework;
namespace NUnitNamespace
{
    public class UnitTest1
    {
        [Category("CategoryA")]
        [Property("Priority", 1)]
        [Test]
        public void TestMethod1()
        {
        }
        [Property("Priority", 2)]
        [Test]
        public void TestMethod2()
        {
        }
    }
}

表达式	结果
`dotnet test —filter Method`	运行 `FullyQualifiedName` 包含 `Method` 的测试。在 `vstest 15.1+` 中可用。
`dotnet test —filter Name~TestMethod1`	运行名称包含 `TestMethod1` 的测试。
`dotnet test —filter FullyQualifiedName~NUnitNamespace.UnitTest1`	运行属于类 `NUnitNamespace.UnitTest1` 的测试。
`dotnet test —filter FullyQualifiedName!=NUnitNamespace.UnitTest1.TestMethod1`	运行除 `NUnitNamespace.UnitTest1.TestMethod1` 之外的其他所有测试。
`dotnet test —filter TestCategory=CategoryA`	运行含 `[Category("CategoryA")]` 批注的测试。
`dotnet test —filter Priority=2`	运行含 `[Priority(2)]` 批注的测试。

使用条件运算符 | 和 &

表达式	结果
`dotnet test —filter "FullyQualifiedName~UnitTest1\|TestCategory=CategoryA"`	运行 `FullyQualifiedName` 包含 `UnitTest1` 或 `TestCategory` 是 `CategoryA` 的测试。
`dotnet test —filter "FullyQualifiedName~UnitTest1&TestCategory=CategoryA"`	运行 `FullyQualifiedName` 包含 `UnitTest1` 且 `TestCategory` 是 `CategoryA` 的测试。
`dotnet test —filter "(FullyQualifiedName~UnitTest1&TestCategory=CategoryA)\|Priority=1"`	运行 `FullyQualifiedName` 包含 `UnitTest1` 且 `TestCategory` 是 `CategoryA` 或 `Priority` 是 1 的测试。