supported_testing_frameworks.md

Supported Testing Frameworks

JUnit Platform (JUnit Jupiter or JUnit Vintage)

BlockHound ships with an optional module providing a JUnit Platform TestExecutionListener:

'io.projectreactor.tools:blockhound-junit-platform:$VERSION'

⚠️ Due to a bug in Gradle, Gradle users must add the following dependency: testRuntime 'org.junit.platform:junit-platform-launcher' (version 1.0.0 or higher)

Once you add the blockhound-junit-platform artifact as a dependency, the BlockHound TestExecutionListener will be automatically registered and executed by the JUnit Platform.

The implementation invokes BlockHound.install() (see customization).

Should you need any customizations, you can implement them as custom integrations. Simply implement the reactor.blockhound.integration.BlockHoundIntegration interface and register it in META-INF/services/reactor.blockhound.integration.BlockHoundIntegration.

JUnit 3/4

Unfortunatelly, there is no simple way to add a global lifecycle listener in JUnit 3 or JUnit 4. However, you can use the JUnit Platform integration by running your JUnit 3/4 tests as described in the JUnit 5 User Guide.