讓 MSTest 支援使用資料集進行重覆測試

之前文章 NUnit 幾個參數化測試的方式介紹到如何在 NUnit 單元測試中使用 TestCase、TestCaseSource、Values、ValueSource 來進行參數化測試，也曾在餵資料集給 SpecFlow 來執行測試及驗證中介紹到如何使用 SpecFlow Outline 達成相同目的

公司最近專案的測試 framework 使用 MSTest，不過 MSTest 原生並沒有支援像 NUnit 及 SpecFlow 直接指定值的參數化測試方式，嘗試了幾個方式後，筆記一下個人覺得不錯的做法

安裝 NuGet 套件 - MSTestHacks

使用 Nuget Package Explorer
- 搜尋 MSTestHacks
使用 Package Manager Console
Install-Package MSTestHacks

修改測試程式

引用 namesapce
```
using MSTestHacks;
```

讓測試 class 繼承 TestBase

[TestClass]
public class UnitTest1 : TestBase
{
}

建立測試用的資料集合

可以使用 Property、Field、Method

Prperty

private IEnumerable<string> Projects
{
    get
    {
        return new List<string> { "Yowko Test", "Unit Test", "Yowko Demo" };
    }
}

Method

private IEnumerable<int> GetAges()
{
    return new List<int> { 1,2,3};
}

需回傳 IEnumerable

將測試用資料集指定給測試方法

在測試方法加上 DataSource ，並指定 "{namespace}.{testclass}.{property|field|method}"

Property

[TestMethod]
[DataSource("DemoMSTest.Tests.UnitTest1.Projects")]
public void TestMethod2()
{
}

Method

[TestMethod]
[DataSource("DemoMSTest.Tests.UnitTest1.GetAges")]
public void TestMethod1()
{
}

逐一取出資料集內容並轉型為正確型別即可進行驗證

this.TestContext.GetRuntimeDataSourceObject<{目標型別}>();

Property

[TestMethod]
[DataSource("DemoMSTest.Tests.UnitTest1.Projects")]
public void TestMethod2()
{
    var project = this.TestContext.GetRuntimeDataSourceObject<string>();
    Console.WriteLine(project);
    Assert.IsTrue(project.Contains("Test"));
}

Method

[TestMethod]
[DataSource("DemoMSTest.Tests.UnitTest1.GetAges")]
public void TestMethod1()
{
    var age = this.TestContext.GetRuntimeDataSourceObject<int>();
    Console.WriteLine(age);
    Assert.IsFalse(age<0);
}

測試結果
- 會顯示在同一個測試方法中，有多個測試結果
- 有一測試資料讓測試 fail，則該測試方法就會被標記為 fail

如何驗證例外

曾經在使用 MSTest、Nunit 3、xUnit.net 2.0、NSubstitute、FluentAssertions 驗證例外(exception) 介紹過可以經由安裝 MSTestExtensions 就可以直接使用 Assert.Throws<T>() 來驗證例外，不需在測試方法上加上 [ExpectedException(typeof({exception 型別}))] 以避免失真，但 MSTestExtensions 與今天介紹的 MSTestHacks 都需要讓測試程式繼承自訂的 class，不過 c# 的語言特性只允許繼承一個 class，幸虧 MSTestHacks 已經預想到這個問題 - 它有提供驗證 exception 的語法

僅驗證特定的 exception

ExceptionAssert.Throws<ArgumentNullException>(()=>target.Get());

驗證 exception 及錯誤訊息

ExceptionAssert.Throws<ArgumentException>(() => target.Post(),expectedMessage);

心得

原本想要使用 MSTest 的 DataSource，但預設只支援 xml、csv 跟 database., 嘗試更新到 MSTest V2 測試 DataRow 後，發現使用方法提供資料的支援度不佳，幸虧後來找到 MSTestHacks，省了不少事，加上也涵蓋了 MSTestExtensions 簡易的 exception 驗證方式，非常方便

文章目錄