Class EventFiredWith
EventFiredWith constraint
Property Summary
-
$_dataKey protected
string
Event data key
-
$_dataValue protected
mixed
Event data value
-
$_eventManager protected
Cake\Event\EventManager
Array of fired events
Method Summary
-
__construct() public
Constructor
-
additionalFailureDescription() protected
Return additional failure description where needed.
-
count() public
Counts the number of constraint elements.
-
evaluate() public
Evaluates the constraint for parameter $other.
-
exporter() protected
-
fail() protected
Throws an exception for the given compared value and test description.
-
failureDescription() protected
Returns the description of the failure.
-
matches() public
Checks if event is in fired array
-
toString() public
Assertion message string
Method Detail
__construct() ¶ public
__construct(Cake\Event\EventManager $eventManager, string $dataKey, mixed $dataValue)
Constructor
Parameters
-
Cake\Event\EventManager
$eventManager Event manager to check
-
string
$dataKey Data key
-
mixed
$dataValue Data value
additionalFailureDescription() ¶ protected
additionalFailureDescription(mixed $other): string
Return additional failure description where needed.
The function can be overridden to provide additional failure information like a diff
Parameters
-
mixed
$other evaluated value or object
Returns
string
evaluate() ¶ public
evaluate(mixed $other, string $description = '', bool $returnResult = false)
Evaluates the constraint for parameter $other.
If $returnResult is set to false (the default), an exception is thrown in case of a failure. null is returned otherwise.
If $returnResult is true, the result of the evaluation is returned as a boolean value instead: true in case of success, false in case of a failure.
Parameters
-
$other
-
string
$description optional -
bool
$returnResult optional
Throws
ExpectationFailedException
InvalidArgumentException
fail() ¶ protected
fail(mixed $other, string $description, ?ComparisonFailure $comparisonFailure = null): void
Throws an exception for the given compared value and test description.
Parameters
-
mixed
$other evaluated value or object
-
string
$description Additional information about the test
-
?ComparisonFailure
$comparisonFailure optional
Returns
void
Throws
ExpectationFailedException
InvalidArgumentException
failureDescription() ¶ protected
failureDescription(mixed $other): string
Returns the description of the failure.
The beginning of failure messages is "Failed asserting that" in most cases. This method should return the second part of that sentence.
To provide additional failure information additionalFailureDescription can be used.
Parameters
-
mixed
$other evaluated value or object
Returns
string
Throws
InvalidArgumentException
matches() ¶ public
matches(mixed $other): bool
Checks if event is in fired array
This method can be overridden to implement the evaluation algorithm.
Parameters
-
mixed
$other Constraint check
Returns
bool
Throws
PHPUnit\Framework\AssertionFailedError