Build Status Maven Central Javadoc

Testing asynchronous systems is hard. Not only does it require handling threads, timeouts and concurrency issues, but the intent of the test code can be obscured by all these details. Awaitility is a DSL that allows you to express expectations of an asynchronous system in a concise and easy to read manner. For example:

public void updatesCustomerStatus() throws Exception {
    // Publish an asynchronous event:
    // Awaitility lets you wait until the asynchronous operation completes:
    await().atMost(5, SECONDS).until(customerStatusIsUpdated());

See getting starting and usage guide for more info.

Fork me on GitHub



  • 2018-12-06: Awaitility 3.1.5 is released with two new Kotlin extension functions: untilNull and has. See changelog for details.
  • 2018-12-05: Awaitility 3.1.4 is released with a new Kotlin extension function: untilNotNull. See changelog for details.
  • 2018-11-16: Awaitility 3.1.3 is released with improvements and changes. See changelog for details. Click here for older news.
Release Notes

Release Notes


For minor changes see change log.



Awaitility is developed and maintained by Johan Haleby with the help of numerous other contributors over the years. Would you like to contribute to the project in any way? Submit a pull request or contact Johan at Twitter.

Johan started the project with Jan Kronquist when they were both working at Jayway back in January of 2010. The project is now sponsored by Parkster.