Mocking Framework

Isolate a portion of a system to test by imitating behavior of dependencies

When unit testing, you are often interested in testing a portion of a complete system isolated from dependencies. To test a portion of the system, we can usemock objectsto replace the dependencies. A mock object implements at least part of the same interface as the production object, but often in a simpler, faster, more predictable, or more controllable way.

To get started, seeCreate Mock Object.

Test a component using mocked-up dependencies.

Classes

expand all

General Purpose

`matlab.mock.TestCase`	`TestCase`to write tests with mocking framework
`matlab.mock.AnyArguments`	Match any number of arguments

Mock Object Actions

`matlab.mock.actions.AssignOutputs`	Define return values for method called or property accessed
`matlab.mock.actions.DoNothing`	Take no action
`matlab.mock.actions.Invoke`	Invoke function handle when method is called
`matlab.mock.actions.ReturnStoredValue`	Return stored property value
`matlab.mock.actions.StoreValue`	Store property value
`matlab.mock.actions.ThrowException`	Throw exception when method is called or when property is set or accessed

Mock Object Constraints

`matlab.mock.constraints.Occurred`	Constraint qualifying mock object interactions
`matlab.mock.constraints.WasAccessed`	Constraint determining property get access
`matlab.mock.constraints.WasCalled`	Constraint determining method call
`matlab.mock.constraints.WasSet`	Constraint determining property set interaction

Behavior Definition and Observation

`matlab.mock.MethodCallBehavior`	Specify mock object method behavior and qualify method calls
`matlab.mock.PropertyBehavior`	Specify mock object property behavior and qualify interactions
`matlab.mock.PropertyGetBehavior`	Specify mock property get behavior
`matlab.mock.PropertySetBehavior`	Specify mock object set behavior

Mock Object Interaction History

`getMockHistory`	Return history of mock interactions from`TestCase`instance
`matlab.mock.InteractionHistory.forMock`	Return history from mock object
`matlab.mock.InteractionHistory`	Interface for mock object interaction history
`matlab.mock.history`	Summary of classes representing mock object interaction history

Topics

Create Mock Object
Test a portion of a complete system in isolation using a mock.
Specify Mock Object Behavior
Define behavior for mocked methods and properties. For example, you can specify that a method returns predefined values.
Qualify Mock Object Interaction
Intercept messages sent from the component under test to the mock object. For example, you can verify that a method was called or a property was set.
Write Tests That Use App Testing and Mocking Frameworks
This example shows how to write tests that use the app testing framework and the mocking framework.