Main Content

matlab.mock.actions.StoreValue class

Package: matlab.mock.actions

Store property value


The StoreValue action specifies that the specified value is stored when setting a property.

By default, when you set property values in strict mocks, MATLAB® throws an exception. To specify that the framework stores the value of a mock object property, use the StoreValue class.


action = StoreValue stores a property value.


repeatRepeat storing property value
thenAction for mock object interaction or action subsequent to storing property value

Copy Semantics

Value. To learn how value classes affect copy operations, see Copying Objects.


collapse all

Create a strict mock. By default, property interactions throw exceptions.

testCase = matlab.mock.TestCase.forInteractiveUse;
properties = ["PropA" "PropB" "PropC"];
[mock, behavior] = testCase.createMock('AddedProperties',properties,"Strict",true);

Enable set access to PropA.

import matlab.mock.actions.StoreValue

Use the mock.

mock.PropA = 1;

Use the mock.

mock.PropB = 2;
Assertion failed.
    Test Diagnostic:
    Unexpected set of strict mock property 'PropB'.
Assertion failed.


For a simple directive to store property values, you can use the storeValueWhen method of the matlab.mock.TestCase class. However, there is more functionality when you use the StoreValue action.

Introduced in R2017a