Moq - 在设置的返回中使用 It.IsAny 时会发生什么？

Question

我正在使用 Moq 在 C# 中执行单元测试。特别是一个测试，我创建了一个接口包装器，System.Net.Mail.SmtpClient以便可以模拟它。

public class SmtpClient : ISmtpClient
{
    public string Host { get; set; }
    public int Port { get; set; }
    public ICredentialsByHost Credentials { get; set; }
    public bool EnableSsl { get; set; }

    public void Send(MailMessage mail)
    {
        var smtpClient = new System.Net.Mail.SmtpClient
        {
            Host = Host,
            Port = Port,
            Credentials = Credentials,
            EnableSsl = EnableSsl
        };

        smtpClient.Send(mail);
    }
}

在我对这个包装器的测试中，为了确保Send()调用该方法，我模拟了接口，并且在设置模拟时，我使用Setup()为该对象的属性赋值。在所有文档中，我看到.Return()这些设置返回了这些方法期望的类型的特定值。但是，在我进一步理解之前，我改为It.IsAny<T>在返回中使用。

[ClassInitialize]
public static void ClassInitialize(TestContext testContext)
{
    _smtpClientMock = new Mock<ISmtpClient>(MockBehavior.Strict);
    _smtpClientMock.Setup(x => x.Port).Returns(8080);
    _smtpClientMock.Setup(x => x.EnableSsl).Returns(false);
    _smtpClientMock.Setup(x => x.Host).Returns("host");
    _smtpClientMock.Setup(x => x.Credentials).Returns(It.IsAny<NetworkCredential>());

    _smtpClientMock.Setup(mockSend => mockSend.Send(It.IsAny<MailMessage>()));
}

[TestMethod]
public void WithValidMailMessageObject_WhenSendIsCalled_EmailClientCallsSmptClientToSendEmail()
{
    //Arrange

    //Act
    _smtpClientMock.Object.Send(new MailMessage());
    //Assert
    _smtpClientMock.Verify(checkMethodIsCalled => checkMethodIsCalled.Send(It.IsAny<MailMessage>()), Times.Once);
}

我注意到的是测试通过了。由于我没有在其他地方看到过这个，我知道这不是最佳实践。我要问的是，为什么不使用它，以及It.IsAny<T>()在Return最小起订量Setup()或模拟对象的内部使用会出现什么问题？

Answer 1

It 用于在 Moq 表达式中过滤和匹配参数。

允许为方法调用中的参数指定匹配条件，而不是特定的参数值。“它”指的是被匹配的参数。

It.IsAny<T>()通常在方法调用的实际参数值不相关时使用。当作为SetuporVerify表达式之外的值传递时，传递It.IsAny<T>()泛型参数的默认值。所以对于引用类型，它将传递null等等。

虽然在您的场景中它不会失败，但通常建议不要将该It类用于除传递给模拟依赖项的匹配参数之外的任何其他内容。

Returns在进行测试时，通常使用来返回使用值。如果被测对象在调用模拟时期望一个值，而模拟Setup将返回It.IsAny<T>()，则测试将以意想不到的方式运行。

鉴于以下简单示例

public interface IDependency {
    string SomeMethod();
}

public MyClass {
    public bool MyMethod(IDependency input) {            
        var value = input.SomeMethod();

        var result = "Output" + value.ToUpper(); //<-- value should not be null

        return result != null;
    }
}

NullReferenceException由于使用不当，以下测试将失败It.IsAny<T>()

[TestMethod]
public void MyMethod_Should_Return_True() {
    //Arrange
    var mock = new Mock<IDependency>();
    mock.Setup(_ => _.SomeMethod()).Returns(It.IsAny<string>());
    var subject = new MyClass();
    var expected = true;

    //Act
    var actual = subject.MyMethod(mock.Object);

    //Assert
    Assert.AreEqual(expected, actual);
}