NUnit3: Assert.Throws with async Task

Question

I am trying to port a test to NUnit3 and am getting a System.ArgumentException : 'async void' methods are not supported, please use 'async Task' instead.

[Test]
public void InvalidUsername()
{
    ...
    var exception = Assert.Throws<HttpResponseException>(async () => await client.LoginAsync("notarealuser@example.com", testpassword));
    exception.HttpResponseMessage.StatusCode.ShouldEqual(HttpStatusCode.BadRequest); // according to http://tools.ietf.org/html/rfc6749#section-5.2
    ...
}

Assert.Throws appears to take a TestDelegate, defined as:

public delegate void TestDelegate();

hence the ArgumentException. What is the best way to port this code?

Related: http://stackoverflow.com/questions/15634542/nunit-async-test-exception-assertion — Marc Gravell, Nov 19 '14 at 18:56

Zabbu · Answer 1 · 2017-02-03T19:33:52.863

118

This was resolved by Nunit. You can now use Assert.ThrowsAsync<>()

https://github.com/nunit/nunit/issues/1190

Example:

Assert.ThrowsAsync<Exception>(() => YourAsyncMethod());

edited Feb 03 '17 at 19:33

answered Mar 18 '16 at 12:43

Zabbu

1,387
1
8
11

arni · Answer 2 · 2019-05-25T19:06:05.547

I would recommend the following code instead of Assert.ThrowsAsync, as this is more readable:

// Option A
[Test]
public void YourAsyncMethod_Throws_YourException_A()
{
    // Act
    AsyncTestDelegate act = () => YourAsyncMethod();

    // Assert
    Assert.That(act, Throws.TypeOf<YourException>());
}

// Option B (local function)
[Test]
public void YourAsyncMethod_Throws_YourException_B()
{
    // Act
    Task Act() => YourAsyncMethod();

    // Assert
    Assert.That(Act, Throws.TypeOf<YourException>());
}

score 1 · Answer 3 · answered Feb 16 '16 at 21:42

I ended up writing a static function that mirrors what NUnit does. There was a whole conversation at https://github.com/nunit/nunit/issues/464 about this.

public static async Task<T> Throws<T>(Func<Task> code) where T : Exception
{
    var actual = default(T);

    try
    {
        await code();
        Assert.Fail($"Expected exception of type: {typeof (T)}");
    }
    catch (T rex)
    {
        actual = rex;
    }
    catch (Exception ex)
    {
        Assert.Fail($"Expected exception of type: {typeof(T)} but was {ex.GetType()} instead");
    }

    return actual;
}

Then from my tests I can use it such as

var ex = await CustomAsserts.Throws<HttpResponseException>(async () => await client.DoThings());
Assert.IsTrue(ex.Response.StatusCode == HttpStatusCode.BadRequest);

I just used your solution and with some tweaks it does exactly what I hoped. Thanks. — Scottymac, May 14 '21 at 22:24

score 0 · Answer 4 · answered Feb 04 '16 at 17:38

To ensure the exception was thrown, it's better to not assert in the catch block if you so choose to use one. This way, you can be sure the correct exception type is thrown because otherwise you'll get a null reference or an uncaught different exception.

HttpResponseException expectedException = null;
try
{
    await  client.LoginAsync("notarealuser@example.com", testpassword));         
}
catch (HttpResponseException ex)
{
    expectedException = ex;
}

Assert.AreEqual(HttpStatusCode.NoContent, expectedException.Response.BadRequest);

Hi @BrianPMorin, throwing `NullReferenceException` should be avoided as it would lead to a confusion while analysing a failed test. I'd suggest you to write `Assert.That(expectedException, Is.NotNull)` before checking the HTTP Status Code. — AlexMelw, Oct 20 '22 at 11:54

score -5 · Answer 5 · edited Nov 23 '15 at 22:26

-5

You could try using something like this:

 try
 {
     await client.LoginAsync("notarealuser@example.com", testpassword);
 }
 catch (Exception ex)
 {
     Assert.That(ex, Is.InstanceOf(typeof (HttpResponseException)));
 }

edited Nov 23 '15 at 22:26

angelcool.net

2,505
1
24
26

answered Nov 23 '15 at 22:01

woitheq

1

1

Hi @woitheq, `await client.LoginAsync("notarealuser@example.com", testpassword);` could not throw an exception. In that case the `catch` block and as a result the `Assert` statement are ignored. – AlexMelw Oct 20 '22 at 11:21

NUnit3: Assert.Throws with async Task

5 Answers5