Package org.gradle.api.tasks.testing

Interface TestResult

  • public interface TestResult
    Describes a test result.

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Interface Description
      static class  TestResult.ResultType
      The final status of a test.

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      long getEndTime()
      Returns the time when this test completed execution.
      java.lang.Throwable getException()
      If the test failed with an exception, this will be the exception.
      java.util.List<java.lang.Throwable> getExceptions()
      If the test failed with any exceptions, this will contain the exceptions.
      long getFailedTestCount()
      Returns the number of failed atomic tests executed for this test.
      java.util.List<TestFailure> getFailures()
      If the test failed with any exceptions, this will contain the exceptions and a description of the failure types.
      TestResult.ResultType getResultType()
      Returns the type of result.
      long getSkippedTestCount()
      Returns the number of skipped atomic tests executed for this test.
      long getStartTime()
      Returns the time when this test started execution.
      long getSuccessfulTestCount()
      Returns the number of successful atomic tests executed for this test.
      long getTestCount()
      Returns the total number of atomic tests executed for this test.

    • Method Detail

      • getResultType

        TestResult.ResultType getResultType()
        Returns the type of result. Generally one wants it to be SUCCESS!
        Returns:
        The result type.

      • getException

        @Nullable
java.lang.Throwable getException()
        If the test failed with an exception, this will be the exception. Some test frameworks do not fail without an exception (JUnit), so in those cases this method will never return null.
        Returns:
        The exception, if any, logged for this test. If none, a null is returned.

      • getFailures

        @Incubating
java.util.List<TestFailure> getFailures()
        If the test failed with any exceptions, this will contain the exceptions and a description of the failure types.
        Returns:
        The failures, if any, logged for this test. If none, an empty list is returned.
        Since:
        7.6
        See Also:
        getExceptions()

      • getExceptions

        java.util.List<java.lang.Throwable> getExceptions()
        If the test failed with any exceptions, this will contain the exceptions. Some test frameworks do not fail without an exception (JUnit), so in those cases this method will never return an empty list.
        Returns:
        The exceptions, if any, logged for this test. If none, an empty list is returned.

      • getStartTime

        long getStartTime()
        Returns the time when this test started execution.
        Returns:
        The start time, in milliseconds since the epoch.

      • getEndTime

        long getEndTime()
        Returns the time when this test completed execution.
        Returns:
        The end t ime, in milliseconds since the epoch.

      • getTestCount

        long getTestCount()
        Returns the total number of atomic tests executed for this test. This will return 1 if this test is itself an atomic test.
        Returns:
        The number of tests, possibly 0

      • getSuccessfulTestCount

        long getSuccessfulTestCount()
        Returns the number of successful atomic tests executed for this test.
        Returns:
        The number of tests, possibly 0

      • getFailedTestCount

        long getFailedTestCount()
        Returns the number of failed atomic tests executed for this test.
        Returns:
        The number of tests, possibly 0

      • getSkippedTestCount

        long getSkippedTestCount()
        Returns the number of skipped atomic tests executed for this test.
        Returns:
        The number of tests, possibly 0