Write function-based tests to check that the outputs of MATLAB® scripts, functions, or classes are as you expect. You can use a full library of qualification functions to produce four different types of test failures. For example, you can produce verification or fatal assertion test failures. Function-based tests subscribe to the xUnit testing philosophy.
To get started, see Write Function-Based Unit Tests and Write Simple Test Case Using Functions.
For more advanced test authoring, including using test parameterization and test fixtures, consider writing Class-Based Unit Tests.
functiontests |
Create array of tests from handles to local functions |
runtests |
Run set of tests |
testsuite |
Create suite of tests |
TestSuite.run |
Run TestSuite array using TestRunner object configured for text output |
Test |
Specification of a single test method |
FunctionTestCase |
TestCase used for function-based tests |
TestResult |
Result of running test suite |
Write Function-Based Unit Tests
Your test function is a single MATLAB file that contains a main function and your individual local test functions. Optionally, you can include file fixture and fresh fixture functions.
Write Simple Test Case Using Functions
This example shows how to write and run a function-based unit test.
Write Test Using Setup and Teardown Functions
This example shows how to write a function-based test with setup and teardown functions that run once in your test file and before and after each test function in the file.
This example shows how to analyze the information returned by a test runner.
This example shows how to identify and rerun failed tests.
Additional Topics for Function-Based Tests
Access additional functionality using function-based tests, including application of fixtures, test selection, programmatic access of test diagnostics, and test runner customization.
Qualifications are functions for testing values and responding to failures. This summary describes the four types of qualifications and qualification functions that are available in the MATLAB unit testing framework.
Assumption failures produce filtered tests that are
marked as Incomplete instead of producing test
failures. To avoid test code that is not executed, monitor the filtered
tests.