mstest-skill

MSTest テストスキル

基本パターン

基本的なテスト

using Microsoft.VisualStudio.TestTools.UnitTesting;

[TestClass]
public class CalculatorTests
{
    private Calculator _calc;

    [TestInitialize]
    public void SetUp() => _calc = new Calculator();

    [TestMethod]
    public void Add_TwoNumbers_ReturnsSum()
    {
        Assert.AreEqual(5, _calc.Add(2, 3));
    }

    [TestMethod]
    [ExpectedException(typeof(DivideByZeroException))]
    public void Divide_ByZero_Throws()
    {
        _calc.Divide(10, 0);
    }
}

データ駆動テスト

[DataTestMethod]
[DataRow(2, 3, 5)]
[DataRow(-1, 1, 0)]
[DataRow(0, 0, 0)]
public void Add_Parameterized(int a, int b, int expected)
{
    Assert.AreEqual(expected, _calc.Add(a, b));
}

[DataTestMethod]
[DynamicData(nameof(GetTestData), DynamicDataSourceType.Method)]
public void Add_DynamicData(int a, int b, int expected)
{
    Assert.AreEqual(expected, _calc.Add(a, b));
}

private static IEnumerable<object[]> GetTestData()
{
    yield return new object[] { 1, 2, 3 };
    yield return new object[] { 10, -5, 5 };
}

アサーション

Assert.AreEqual(expected, actual);
Assert.AreNotEqual(unexpected, actual);
Assert.IsTrue(condition);
Assert.IsFalse(condition);
Assert.IsNull(obj);
Assert.IsNotNull(obj);
Assert.IsInstanceOfType(obj, typeof(MyClass));
Assert.ThrowsException<ArgumentException>(() => Method());
CollectionAssert.Contains(list, item);
CollectionAssert.AreEquivalent(expected, actual);
StringAssert.Contains(str, "substring");
StringAssert.StartsWith(str, "prefix");
StringAssert.Matches(str, new Regex(@"\d+"));

ライフサイクル

[AssemblyInitialize]  → Once per assembly (static)
[ClassInitialize]     → Once per class (static)
[TestInitialize]      → Before each test
[TestMethod]          → Test
[TestCleanup]         → After each test
[ClassCleanup]        → Once after class (static)
[AssemblyCleanup]     → Once after assembly (static)

カテゴリ

[TestMethod, TestCategory("Smoke")]
public void QuickTest() { }

[TestMethod, Ignore("Bug #456")]
public void SkippedTest() { }

[TestMethod, Timeout(5000)]
public void TimedTest() { }

セットアップ：dotnet add package MSTest.TestFramework MSTest.TestAdapter Microsoft.NET.Test.Sdk

実行：dotnet test または dotnet test --filter "TestCategory=Smoke"

高度なパターン

本番環境向けのパターンについては、reference/playbook.md を参照してください。

セクション	内容
§1 プロジェクトのセットアップ	.csproj の依存関係、並列実行とカバレッジ設定を含む .runsettings
§2 テストパターン	TestMethod、DataTestMethod、DynamicData、例外テスト
§3 FluentAssertions	AssertionScope、非同期例外、コレクションのアサーション
§4 クラスとアセンブリの初期化	Testcontainers、コストの高いセットアップの共有、グローバル設定
§5 WebApplicationFactory	インメモリ DB を使用した API 統合テスト
§6 Bogus テストデータ	現実的なデータ生成のための Faker パターン
§7 TestContext とログ記録	診断出力、カテゴリ、タイムアウト
§8 CI/CD 統合	カバレッジレポートとしきい値を含む GitHub Actions
§9 デバッグ表	よくある問題 12 件と原因および解決方法
§10 ベストプラクティス	本番環境向けの 14 項目のチェックリスト