Mockery Exceptions¶
Mockery throws three types of exceptions when it cannot verify a mock object.
\Mockery\Exception\InvalidCountException
\Mockery\Exception\InvalidOrderException
\Mockery\Exception\NoMatchingExpectationException
You can capture any of these exceptions in a try…catch block to query them for specific information which is also passed along in the exception message but is provided separately from getters should they be useful when logging or reformatting output.
MockeryExceptionInvalidCountException¶
The exception class is used when a method is called too many (or too few) times and offers the following methods:
getMock()
- return actual mock objectgetMockName()
- return the name of the mock objectgetMethodName()
- return the name of the method the failing expectation is attached togetExpectedCount()
- return expected callsgetExpectedCountComparative()
- returns a string, e.g.<=
used to compare to actual countgetActualCount()
- return actual calls made with given argument constraints
MockeryExceptionInvalidOrderException¶
The exception class is used when a method is called outside the expected order
set using the ordered()
and globally()
expectation modifiers. It
offers the following methods:
getMock()
- return actual mock objectgetMockName()
- return the name of the mock objectgetMethodName()
- return the name of the method the failing expectation is attached togetExpectedOrder()
- returns an integer represented the expected index for which this call was expectedgetActualOrder()
- return the actual index at which this method call occurred.
MockeryExceptionNoMatchingExpectationException¶
The exception class is used when a method call does not match any known expectation. All expectations are uniquely identified in a mock object by the method name and the list of expected arguments. You can disable this exception and opt for returning NULL from all unexpected method calls by using the earlier mentioned shouldIgnoreMissing() behaviour modifier. This exception class offers the following methods:
getMock()
- return actual mock objectgetMockName()
- return the name of the mock objectgetMethodName()
- return the name of the method the failing expectation is attached togetActualArguments()
- return actual arguments used to search for a matching expectation