1. class
  2. PHPUnit
  3. \
  4. Framework
  5. \
  6. TestResult

TestResult

class TestResult implements Countable (View source)

A TestResult collects the results of executing a test case.

Properties

protected array $passed
protected array $errors
protected array $failures
protected array $warnings
protected array $notImplemented
protected array $risky
protected array $skipped
protected array $listeners
protected int $runTests
protected float $time
protected TestSuite $topTestSuite
protected CodeCoverage $codeCoverage Code Coverage information.
protected bool $convertErrorsToExceptions
protected bool $stop
protected bool $stopOnError
protected bool $stopOnFailure
protected bool $stopOnWarning
protected bool $beStrictAboutTestsThatDoNotTestAnything
protected bool $beStrictAboutOutputDuringTests
protected bool $beStrictAboutTodoAnnotatedTests
protected bool $beStrictAboutResourceUsageDuringSmallTests
protected bool $enforceTimeLimit
protected int $timeoutForSmallTests
protected int $timeoutForMediumTests
protected int $timeoutForLargeTests
protected bool $stopOnRisky
protected bool $stopOnIncomplete
protected bool $stopOnSkipped
protected bool $lastTestFailed

Methods

addListener(TestListener $listener)

Registers a TestListener.

removeListener(TestListener $listener)

Unregisters a TestListener.

flushListeners()

Flushes all flushable TestListeners.

addError(Test $test, Throwable $t, float $time)

Adds an error to the list of errors.

addWarning(Test $test, Warning $e, float $time)

Adds a warning to the list of warnings.

addFailure(Test $test, AssertionFailedError $e, float $time)

Adds a failure to the list of failures.

startTestSuite(TestSuite $suite)

Informs the result that a testsuite will be started.

endTestSuite(TestSuite $suite)

Informs the result that a testsuite was completed.

startTest(Test $test)

Informs the result that a test will be started.

endTest(Test $test, float $time)

Informs the result that a test was completed.

bool
allHarmless()

Returns true if no risky test occurred.

int
riskyCount()

Gets the number of risky tests.

bool
allCompletelyImplemented()

Returns true if no incomplete test occurred.

int
notImplementedCount()

Gets the number of incomplete tests.

array
risky()

Returns an Enumeration for the risky tests.

array
notImplemented()

Returns an Enumeration for the incomplete tests.

bool
noneSkipped()

Returns true if no test has been skipped.

int
skippedCount()

Gets the number of skipped tests.

array
skipped()

Returns an Enumeration for the skipped tests.

int
errorCount()

Gets the number of detected errors.

array
errors()

Returns an Enumeration for the errors.

int
failureCount()

Gets the number of detected failures.

array
failures()

Returns an Enumeration for the failures.

int
warningCount()

Gets the number of detected warnings.

array
warnings()

Returns an Enumeration for the warnings.

array
passed()

Returns the names of the tests that have passed.

TestSuite
topTestSuite()

Returns the (top) test suite.

bool
getCollectCodeCoverageInformation()

Returns whether code coverage information should be collected.

run(Test $test)

Runs a TestCase.

int
count()

Gets the number of run tests.

bool
shouldStop()

Checks whether the test run should stop.

stop()

Marks that the test run should stop.

CodeCoverage
getCodeCoverage()

Returns the code coverage object.

setCodeCoverage(CodeCoverage $codeCoverage)

Sets the code coverage object.

convertErrorsToExceptions(bool $flag)

Enables or disables the error-to-exception conversion.

bool
getConvertErrorsToExceptions()

Returns the error-to-exception conversion setting.

stopOnError(bool $flag)

Enables or disables the stopping when an error occurs.

stopOnFailure(bool $flag)

Enables or disables the stopping when a failure occurs.

stopOnWarning(bool $flag)

Enables or disables the stopping when a warning occurs.

beStrictAboutTestsThatDoNotTestAnything(bool $flag)

No description

bool
isStrictAboutTestsThatDoNotTestAnything()

No description

beStrictAboutOutputDuringTests(bool $flag)

No description

bool
isStrictAboutOutputDuringTests()

No description

beStrictAboutResourceUsageDuringSmallTests(bool $flag)

No description

bool
isStrictAboutResourceUsageDuringSmallTests()

No description

enforceTimeLimit(bool $flag)

No description

bool
enforcesTimeLimit()

No description

beStrictAboutTodoAnnotatedTests(bool $flag)

No description

bool
isStrictAboutTodoAnnotatedTests()

No description

stopOnRisky(bool $flag)

Enables or disables the stopping for risky tests.

stopOnIncomplete(bool $flag)

Enables or disables the stopping for incomplete tests.

stopOnSkipped(bool $flag)

Enables or disables the stopping for skipped tests.

float
time()

Returns the time spent running the tests.

bool
wasSuccessful()

Returns whether the entire test was successful or not.

setTimeoutForSmallTests(int $timeout)

Sets the timeout for small tests.

setTimeoutForMediumTests(int $timeout)

Sets the timeout for medium tests.

setTimeoutForLargeTests(int $timeout)

Sets the timeout for large tests.

int
getTimeoutForLargeTests()

Returns the set timeout for large tests.

setRegisterMockObjectsFromTestArgumentsRecursively(bool $flag)

No description

array
getHierarchy(string $className, bool $asReflectionObjects = false)

Returns the class hierarchy for a given class.

Details

at line 194
addListener(TestListener $listener)

Registers a TestListener.

Parameters

TestListener $listener

at line 204
removeListener(TestListener $listener)

Unregisters a TestListener.

Parameters

TestListener $listener

at line 216
flushListeners()

Flushes all flushable TestListeners.

at line 232
addError(Test $test, Throwable $t, float $time)

Adds an error to the list of errors.

Parameters

Test $test
Throwable $t
float $time

at line 289
addWarning(Test $test, Warning $e, float $time)

Adds a warning to the list of warnings.

The passed in exception caused the warning.

Parameters

Test $test
Warning $e
float $time

at line 312
addFailure(Test $test, AssertionFailedError $e, float $time)

Adds a failure to the list of failures.

The passed in exception caused the failure.

Parameters

Test $test
AssertionFailedError $e
float $time

at line 361
startTestSuite(TestSuite $suite)

Informs the result that a testsuite will be started.

Parameters

TestSuite $suite

at line 377
endTestSuite(TestSuite $suite)

Informs the result that a testsuite was completed.

Parameters

TestSuite $suite

at line 389
startTest(Test $test)

Informs the result that a test will be started.

Parameters

Test $test

at line 405
endTest(Test $test, float $time)

Informs the result that a test was completed.

Parameters

Test $test
float $time

at line 432
bool allHarmless()

Returns true if no risky test occurred.

Return Value

bool

at line 442
int riskyCount()

Gets the number of risky tests.

Return Value

int

at line 452
bool allCompletelyImplemented()

Returns true if no incomplete test occurred.

Return Value

bool

at line 462
int notImplementedCount()

Gets the number of incomplete tests.

Return Value

int

at line 472
array risky()

Returns an Enumeration for the risky tests.

Return Value

array

at line 482
array notImplemented()

Returns an Enumeration for the incomplete tests.

Return Value

array

at line 492
bool noneSkipped()

Returns true if no test has been skipped.

Return Value

bool

at line 502
int skippedCount()

Gets the number of skipped tests.

Return Value

int

at line 512
array skipped()

Returns an Enumeration for the skipped tests.

Return Value

array

at line 522
int errorCount()

Gets the number of detected errors.

Return Value

int

at line 532
array errors()

Returns an Enumeration for the errors.

Return Value

array

at line 542
int failureCount()

Gets the number of detected failures.

Return Value

int

at line 552
array failures()

Returns an Enumeration for the failures.

Return Value

array

at line 562
int warningCount()

Gets the number of detected warnings.

Return Value

int

at line 572
array warnings()

Returns an Enumeration for the warnings.

Return Value

array

at line 582
array passed()

Returns the names of the tests that have passed.

Return Value

array

at line 592
TestSuite topTestSuite()

Returns the (top) test suite.

Return Value

TestSuite

at line 602
bool getCollectCodeCoverageInformation()

Returns whether code coverage information should be collected.

Return Value

bool If code coverage should be collected

at line 612
run(Test $test)

Runs a TestCase.

Parameters

Test $test

at line 900
int count()

Gets the number of run tests.

Return Value

int

at line 910
bool shouldStop()

Checks whether the test run should stop.

Return Value

bool

at line 918
stop()

Marks that the test run should stop.

at line 928
CodeCoverage getCodeCoverage()

Returns the code coverage object.

Return Value

CodeCoverage

at line 938
setCodeCoverage(CodeCoverage $codeCoverage)

Sets the code coverage object.

Parameters

CodeCoverage $codeCoverage

at line 950
convertErrorsToExceptions(bool $flag)

Enables or disables the error-to-exception conversion.

Parameters

bool $flag

Exceptions

Exception

at line 964
bool getConvertErrorsToExceptions()

Returns the error-to-exception conversion setting.

Return Value

bool

at line 976
stopOnError(bool $flag)

Enables or disables the stopping when an error occurs.

Parameters

bool $flag

Exceptions

Exception

at line 992
stopOnFailure(bool $flag)

Enables or disables the stopping when a failure occurs.

Parameters

bool $flag

Exceptions

Exception

at line 1008
stopOnWarning(bool $flag)

Enables or disables the stopping when a warning occurs.

Parameters

bool $flag

Exceptions

Exception

at line 1022
beStrictAboutTestsThatDoNotTestAnything(bool $flag)

Parameters

bool $flag

Exceptions

Exception

at line 1034
bool isStrictAboutTestsThatDoNotTestAnything()

Return Value

bool

at line 1044
beStrictAboutOutputDuringTests(bool $flag)

Parameters

bool $flag

Exceptions

Exception

at line 1056
bool isStrictAboutOutputDuringTests()

Return Value

bool

at line 1066
beStrictAboutResourceUsageDuringSmallTests(bool $flag)

Parameters

bool $flag

Exceptions

Exception

at line 1078
bool isStrictAboutResourceUsageDuringSmallTests()

Return Value

bool

at line 1088
enforceTimeLimit(bool $flag)

Parameters

bool $flag

Exceptions

Exception

at line 1100
bool enforcesTimeLimit()

Return Value

bool

at line 1110
beStrictAboutTodoAnnotatedTests(bool $flag)

Parameters

bool $flag

Exceptions

Exception

at line 1122
bool isStrictAboutTodoAnnotatedTests()

Return Value

bool

at line 1134
stopOnRisky(bool $flag)

Enables or disables the stopping for risky tests.

Parameters

bool $flag

Exceptions

Exception

at line 1150
stopOnIncomplete(bool $flag)

Enables or disables the stopping for incomplete tests.

Parameters

bool $flag

Exceptions

Exception

at line 1166
stopOnSkipped(bool $flag)

Enables or disables the stopping for skipped tests.

Parameters

bool $flag

Exceptions

Exception

at line 1180
float time()

Returns the time spent running the tests.

Return Value

float

at line 1190
bool wasSuccessful()

Returns whether the entire test was successful or not.

Return Value

bool

at line 1202
setTimeoutForSmallTests(int $timeout)

Sets the timeout for small tests.

Parameters

int $timeout

Exceptions

Exception

at line 1218
setTimeoutForMediumTests(int $timeout)

Sets the timeout for medium tests.

Parameters

int $timeout

Exceptions

Exception

at line 1234
setTimeoutForLargeTests(int $timeout)

Sets the timeout for large tests.

Parameters

int $timeout

Exceptions

Exception

at line 1248
int getTimeoutForLargeTests()

Returns the set timeout for large tests.

Return Value

int

at line 1256
setRegisterMockObjectsFromTestArgumentsRecursively(bool $flag)

Parameters

bool $flag

at line 1273
protected array getHierarchy(string $className, bool $asReflectionObjects = false)

Returns the class hierarchy for a given class.

Parameters

string $className
bool $asReflectionObjects

Return Value

array