Documentation

In the Editor, create a test in a file named sampleTest.m. When you save the test, the Run section in the Editor tab changes to Run Tests.

function tests = sampleTest
    tests = functiontests(localfunctions);
end

function testA(testCase)
    verifyEqual(testCase,5,5)
end

function testB(testCase)
    verifyGreaterThan(testCase,42,13)
end

function testC(testCase)
    verifySubstring(testCase,'hello, world','llo')
end

Click the Run Tests icon. MATLAB^® displays the command it uses to run the tests in the Command Window, and the test output follows. MATLAB runs all three tests from sampleTest.m.

runtests('sampleTest')

Running sampleTest
...
Done sampleTest
__________


ans = 

  1×3 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   3 Passed, 0 Failed, 0 Incomplete.
   0.0071673 seconds testing time.

In the Editor, place your cursor in the testB function and click the Run Current Test icon. MATLAB runs testB only.

runtests('sampleTest','ProcedureName','testB')

Running sampleTest
.
Done sampleTest
__________


ans = 

  TestResult with properties:

          Name: 'sampleTest/testB'
        Passed: 1
        Failed: 0
    Incomplete: 0
      Duration: 9.9411e-04
       Details: [1×1 struct]

Totals:
   1 Passed, 0 Failed, 0 Incomplete.
   0.00099411 seconds testing time.

In addition to running tests, you can customize the test run using the test options under the Run Tests icon. MATLAB uses test options whether you run all the tests in a file or just the test at your cursor location.

When you select a test option, the selection persists for the duration of your current MATLAB session.