今回はC#のユニットテストフレームワークの一つである、 FluentAssertions でよく使う検証メソッドについて、使用例とどのようなときに使っているのかをまとめていきたいと思います。

• FluentAssertions 6.10.0
• .NET Framework 4.8

（おそらく）一番メジャーなC#のユニットテストフレームワークです。

Assert.AreEqual() のように書く MSTest よりも人間に理解しやすい拡張メソッドでの提供になっていたり、 MSTest よりもできることが多いです。

ただ、 公式ドキュメント を見てもわかる通り、できることが多すぎて逆にどのような場合にどのメソッドを使うのがいいの？ってなることがあるんですよね。
そのような方々のためによく使う、使えるメソッドをいくつかあげてみようと思います。

[TestMethod]
public void TestMethod1
{
    var actual = 3 + 2;
    var expected = 5;
    actual.Should().Be(expected); // Successfully
}

知っている方もいらっしゃると思いますがよく使用されるものです。

FluentAssertions メソッドは、「実際の値.Should().Be(期待値)」という形が基本です。
英文法的に理解しやすくていいですよね。

[TestMethod]
public void TestMethod2
{
    object? actual = null;
    actual.Should().BeNull(); // Successfully
}
 実際の値がNullかどうかを検証してくれます。そこそこ使います。

[TestMethod]
public void TestMethod3
{
    var actual = true;
    actual.Should().BeTrue(); // Successfully
    actual.Should().BeFalse(); // Failure
}

実際の値がTrueかどうか、Falseかどうかを検証してくれます。 Should().Be()でやることが多く、実はあまり使わないかも。

[TestMethod]
public void TestMethod4
{
    var actual = new[] { "Apple", "Grape", "Banana" };
    var expected = new[] { "Apple", "Grape", "Banana" };
    actual.Should().ContainInOrder(expected); // Successfully
}

コレクションの検証には Should().ContainInOrder() をよく使っています。 これは順序まで見てくれるためです。

public class Sample
{
    public string Hoge { get; set; }
}

[TestMethod]
public void TestMethod5
{
    var actual = new Sample() { Hoge = "fugafuga" };
    var expected = new Sample() { Hoge = "fugafuga" };
    actual.Should().BeEquivalentTo(expected); // Successfully
}

オブジェクト（クラスなど）の検証をしてくれます。Should().Be() の次ぐらいにめちゃくちゃ使ってます。

Should().Be() でのオブジェクトの検証は異なるインスタンスだと失敗になります（ == での等価比較と同様）。
そのためこちらを利用することになります。

複雑な構造をしているクラスを返すメソッドを検証したいときに利用することが多いですね。

オブジェクトの比較では、第二引数のオプションを利用することでより細かい条件を付与することができます。サンプルコードはオプションメソッド WithStrictOrdering() を利用して、オブジェクトのコレクションを順序まで検証しています。

他にもたくさんのオプションメソッドが用意されています。
公式ドキュメントのオブジェクト比較のページ を見て、いろいろ試してみるといいかもしれません。

[TestMethod]
public void TestMethod7
{
    Action action = () =>
    {
        throw new ArgumentException("この値は不正です。");
    }

    action.Should().Throw<ArgumentException>(); // 例外の型だけ検証
    action.Should().Throw<ArgumentException>().WithMessage("この値は不正です。"); // メッセージまで検証
}

WithInnerException() を利用することで、内部例外の検証も可能です。
非同期処理、並列処理などで AggregateException が発生する場面で利用することが多いです。

[TestMethod]
public void TestMethod8
{
    Action action = () =>
    {
        // エラー処理
    }

    action.Should().Throw<AggregateException>().WithInnerException<TimeoutException>();
}

WithInnerException() を利用することで、内部例外の検証も可能です。非同期処理、並列処理などで AggregateException が発生する場面で利用することが多いです。 

今回は私が個人的によく使う、使えると思った FluentAssertions 検証メソッドを紹介しました。

公式ドキュメントにもある通り、FluentAssertions はここで紹介したメソッド以外にも多くの便利な検証メソッドが用意されています。
こういうのは実際に使って試してみるのが一番です。

余談ですが、FluentAssertions を使ってて感じたのが、メジャーなフレームワークの割には意外と日本語の記事が出てこないんですよね。
なのでこの記事が少しでも実装の助けになればと思ってます！