Mock ApiException on Refit

I use Refit to call web api in my code

I also like use StatusCode 422 when the web api have to report that there is a logic error in the application and not an exception and use test, to verify the code.

So I want write here about this problem, how, with mock and Refit we can test that the application report correctly the 422 status code and a string error(or anything else)

WebApi

My web api have a class with a response and an error property.

public class Response
{
    public string Error { get; set; }
    public void SetError(string error)
    {
        Error = error;
    }
}

And the interface of refit

public interface IClient
{
    [Post("/Controller/MyMethod")]
    Task MyMethod([Body]Parameters parameters);
}

The working code could be something like this

public string ApiCaller(IClient client)
{
    try
    {
        await client.MyMethod
        (
            new Parameters(...);
        );
    }
    catch(ApiException ex) when (ex.StatusCode == HttpStatusCode.UnprocessableEntty)
    {
        return ex.GetContentAsync().Result.Errors
    }
    return string.Empty;
}

With this code we can retrive the error when Refit throws an ApiException. If another Exception is throws(500, 404 ...) there will be an exception that we can catch with anoter catch statement or in a centralized way.

The test

We use a MockApiException to build the exception used by mock

public static MockApiException
{
    public static ApiException CreateApiException(HttpStatusCode statusCode, T content)
    {
        var refitSettings = new RefitSettings;
        return ApiException.Create(null, null, 
            new HttpResponseMessage
            {
                StatusCode = statusCode,
                Content = refitSettings.ContentSerializer.ToHttpContent(content)
            }, refitSettings).result;
    }
}

We can Mock the client and use MockApiException to build the exception that mock will throw

var response = new Response("Error thrown by web api")
var mockClient = new Mock();
mockClient.Setup(x => x.MyMethod(
    It.Is(...)
))
.Thrown(MockApiException.CreateApiException(HttpStatusCode.UnprocessableEntity, response);

Now you can test that when we call ApiCaller and refit throw a 422 Exception, the result is the equal to the error.

var result = ApiCaller(mockClient.Object);  
Assert.That(result == "Error thrown by web api");

Bye !