# run

abstract fun run()(source)

Executes the tests, blocking until complete.

#### Since

2.6

#### Throws

org.gradle.tooling.TestExecutionException

when one or more tests fail, or no tests for execution declared or no matching tests can be found.

org.gradle.tooling.UnsupportedVersionException

When the target Gradle version does not support test execution.

org.gradle.tooling.exceptions.UnsupportedBuildArgumentException

When there is a problem with build arguments provided by withArguments.

org.gradle.tooling.exceptions.UnsupportedOperationConfigurationException

When the target Gradle version does not support some requested configuration option.

org.gradle.tooling.BuildException

On some failure while executing the tests in the Gradle build.

org.gradle.tooling.BuildCancelledException

When the operation was cancelled before it completed successfully.

org.gradle.tooling.GradleConnectionException

On some other failure using the connection.

java.lang.IllegalStateException

When the connection has been closed or is closing.

abstract fun run(handler: ResultHandler<in Void>)(source)

Starts executing the tests. This method returns immediately, and the result is later passed to the given handler.

If the operation fails, the handler's onFailure method is called with the appropriate exception. See run for a description of the various exceptions that the operation may fail with.

#### Since

2.6

#### Parameters

handler

The handler to supply the result to.

#### Throws

java.lang.IllegalStateException

When the connection has been closed or is closing.