This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Extend Unit Testing Framework

Customize testing environment; author constraints, fixtures, diagnostics, and plugins

The MATLAB® Unit Testing Frameworks provides test tool authors the ability to customize the testing environment. You can extend test writing through custom constraints, fixtures, and diagnostics, and extend test running and result reporting through custom plugins for the test runner.

Classes

expand all

matlab.unittest.constraints.ConstraintFundamental interface class for comparisons
matlab.unittest.constraints.BooleanConstraintInterface class for boolean combinations of constraints
matlab.unittest.constraints.ToleranceAbstract interface class for tolerances
matlab.unittest.fixtures.FixtureInterface class for test fixtures
matlab.unittest.diagnostics.DiagnosticFundamental interface class for matlab.unittest diagnostics
matlab.unittest.diagnostics.ConstraintDiagnosticDiagnostic with fields common to most constraints
matlab.unittest.plugins.TestRunnerPluginPlugin interface for extending TestRunner
matlab.unittest.plugins.QualifyingPluginInterface for plugins that perform system-wide qualifications
matlab.unittest.plugins.OutputStreamInterface that determines where to send text output
matlab.test.behavior.MissingTest if class satisfies contract for missing values

Packages

matlab.unittest.plugins.plugindataSummary of classes in MATLAB Plugin Data Interface

Topics

Constraints

Create Custom Constraint

This example shows how to create a custom constraint that determines if a given value is the same size as an expected value.

Create Custom Boolean Constraint

This example shows how to create a custom boolean constraint that determines if a given value is the same size as an expected value.

Create Custom Tolerance

This example shows how to create and apply a custom tolerance.

Fixtures

Create Basic Custom Fixture

This example shows how to create a basic custom fixture.

Create Advanced Custom Fixture

This example shows how to create a custom fixture with a configurable constructor.

Plugins

Write Plugins to Extend TestRunner

Use the TestRunnerPlugin class to extend the test runner. You can implement methods to extend the creation, setup, run, and teardown of tests or test fixtures. The TestRunner runs these methods as shown in the figure.

Create Custom Plugin

This example shows how to create a custom plugin that counts the number of passing and failing assertions when running a specified test suite.

Write Plugin to Save Diagnostic Details

This example shows how to create a custom plugin to save diagnostic details. The plugin listens for test failures and saves diagnostic information so you can access it after the framework completes the tests.

Plugin to Generate Custom Test Output Format

This example shows how to create a plugin that uses a custom format to write finalized test results to an output stream.