awaitility/awaitility
Awaitility
Awaitility is a Java asynchronous testing library and conditional polling framework. It provides a fluent domain-specific language to synchronize tests with asynchronous operations by polling for specific states or conditions.
The library allows for the configuration of polling intervals, timeouts, and the assignment of specific threads or services to handle background polling. It includes mechanisms for deadlock detection, exception filtering to treat specific errors as false results, and the ability to fail fast when a prohibited condition is met.
The framework covers state verification, including the monitoring of atomic variables and the verification that specific conditions persist over a defined duration. It also integrates with external assertion libraries to evaluate conditions during asynchronous synchronization.
Features
- Promise-Based State Polling - Provides a mechanism to repeatedly evaluate predicates over time intervals to synchronize tests with asynchronous state changes.
- Asynchronous State Verifications - Acts as a specialized framework for verifying that asynchronous operations eventually reach a desired state via conditional polling.
- Domain Specific Languages - Implements a fluent domain-specific language for declarative configuration of polling behavior and timeouts.
- Exception Suppression - Suppresses specific exception types during polling so they are treated as false rather than failing the test.
- Polling Exception Filters - Allows specific exceptions to be ignored during polling, treating them as unsuccessful attempts rather than test failures.
- Condition Persistence Verifications - Asserts that a specific condition remains true for a defined duration of time.
- Test Background Work Synchronization - Provides mechanisms to synchronize test execution with asynchronous background processes to eliminate flaky assertions.
- Conditional Polling Frameworks - Implements a configurable polling framework with timeouts and exception handling to wait for asynchronous state changes.
- Asynchronous Polling Mechanisms - Provides mechanisms to configure the thread or service that executes the background polling of asynchronous functions.
- Asynchronous Test Handling - Provides capabilities for synchronizing tests by waiting for specific states or values to appear in the application.
- Timeout-Based Verifications - Implements timeout-based verification that compares system state against a boolean supplier to determine success.
- Asynchronous Testing Utilities - Provides a Java-specific DSL for synchronizing tests with asynchronous operations through conditional polling.
- Condition Fail-Fast Controls - Immediately terminates a test when a prohibited condition is met before the desired state is reached.
- Polling Thread Control - Allows control over which thread executes the polling process, including the option to use the current test thread.
- Atomic State Coordination - Monitors atomic structures and shared state using atomic references until a specific value or boolean state is reached.
- Task Status Polling - Implements patterns for checking the completion status of background tasks at defined intervals.
- Custom Thread Executors - Provides the ability to define custom threading contexts and executors for managing how polling conditions are evaluated.
- Value Maintenance Verifications - Ensures a specific condition remains true for a minimum duration within a maximum time window.
- Deadlock and Starvation Detection - Analyzes thread states during timeouts to identify circular dependencies and locking issues in multi-threaded application code.
- Asynchronous Assertions - Integrates with external assertion libraries to perform asynchronous state validation during synchronization.
- Polling Interval Strategies - Offers configurable polling intervals using fixed times, mathematical sequences, or custom logic.
- Testing Frameworks - DSL for synchronizing asynchronous operations.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
