Skip to main content
Version: v2.0

Async Assertion Patterns

Use the same fluent style for async pipelines after awaiting the value.

Async Result Example​

[Fact]
public async Task CreateUser_ValidInput_ReturnsSuccess()
{
    var result = await _service.CreateUserAsync("alice@example.com");

    result.ShouldBe()
        .Success()
        .Where(user => user.Email == "alice@example.com");
}

Async Maybe Example​

[Fact]
public async Task FindUser_UnknownEmail_ReturnsNone()
{
    var maybe = await _service.FindUserAsync("missing@example.com");

    maybe.ShouldBe().None();
}

Pattern Tips​

  • Await first, then assert.
  • Keep assertions deterministic by avoiding timing-dependent side effects.
  • Prefer explicit data setup over implicit shared state.

See Also​