クラスベースのユニットテスト

クラスベーステストの記述、テストのパラメーター化、フィクスチャの適用、テストの選択と実行

xUnit スタイルのテストを記述し、MATLAB^® コードの出力が期待どおりになっているかを確認します。クラスベースのユニットテストでは、ユニットテストフレームワークのすべての機能にアクセスできます。たとえば、パラメーター化されたテストを記述したり、テストにタグを付けたり、共有テストフィクスチャを使用したりできます。

はじめに、MATLAB でのクラスベースのユニットテストの作成およびクラスを使用する単純なテストケースの記述を参照してください。

アプリ

テストブラウザー

Run MATLAB tests and view results (R2023a 以降)

関数

`runtests`	一連のテストの実行
`testsuite`	テストスイートを作成
`testrunner`	Create test runner (R2021a 以降)
`run (TestSuite)`	テキスト出力用に設定された `TestRunner` オブジェクトを使用して配列 `TestSuite` を実行
`run (TestRunner)`	テストスイートを実行
`run (TestCase)`	テストケースに対応するテストを実行
`runInParallel`	配列 `TestSuite` 内のすべてのテストを並列実行

クラス

`matlab.unittest.TestCase`	すべてのテストクラスのスーパークラス
`matlab.unittest.TestSuite`	実行するテストをグループ化する基本的なインターフェイス
`matlab.unittest.Test`	単一のテストの仕様
`matlab.unittest.TestRunner`	`matlab.unittest` フレームワークでテストを実行するためのクラス
`matlab.unittest.TestResult`	実行中のテストスイートの結果

パッケージ

`matlab.unittest`	MATLAB ユニットテストフレームワークのパッケージとクラスの概要
`matlab.unittest.qualifications`	MATLAB の検定インターフェイスのクラスの概要
`matlab.unittest.constraints`	MATLAB 制約インターフェイスのクラスの概要
`matlab.unittest.fixtures`	MATLAB フィクスチャインターフェイスのクラスの概要
`matlab.unittest.parameters`	MATLAB ユニットテストパラメーターに関連付けられたクラスの概要
`matlab.unittest.plugins`	MATLAB プラグインインターフェイスのクラスの概要
`matlab.unittest.selectors`	MATLAB セレクターインターフェイスのクラスの概要
`Simulink.sdi.constraints.MatchesSignal`	シミュレーションデータインスペクターを使用した時系列データと許容誤差との比較を行う制約 (R2019a 以降)

トピック

テストの記述

MATLAB でのクラスベースのユニットテストの作成
MATLAB プログラムをテストするには、検定を使用してユニットテストを作成します。検定とは、値をテストし、エラーに応答するための手法です。
クラスを使用する単純なテストケースの記述
プログラムの正確性を判定するクラスベースのユニットテストを記述する。
クラスを使用するセットアップコードと破棄コードの記述
各 Test メソッドの前後に実行するか、テストクラスのすべての Test メソッドの前後に実行するセットアップコードおよび破棄コードを指定する。
共有フィクスチャを使用するテストの記述
テストを作成する際にフィクスチャをすべてのテストクラスで共有する。
ユニットテストのタグ付け
タグを使ってテストをカテゴリ別にグループ化し、指定したタグでテストを実行します。テストタグは通常、特定機能の識別やテストの種類の説明に使われます。
Insert Test Code Using Editor
Write a parameterized test interactively by using the options in the MATLAB Editor.
検証、アサーション、その他の検定の表
検証、仮定、アサーション、および致命的なアサーションを使用して値をテストし、エラーに対応する。

パラメーター化されたテストの書き込み

クラスベースのテストでのパラメーターの使用
テストで反復的に使用されるデータを指定するには、パラメーターを使用する。
基本的なパラメーター化テストの作成
パラメーター化するテストを Test methods ブロックに作成して、関数をテストする。
高度なパラメーター化テストの作成
TestClassSetup、TestMethodSetup および Test methods の各ブロックでパラメーター化を行うテストを作成する。
Define Parameters at Suite Creation Time
Use a TestParameterDefinition method to define parameters at test suite creation time.
パラメーター化されたテストでの外部パラメーターの使用
データドリブンテストを使用して変数入力をパラメーター化したテストに挿入します。

テストの実行と結果の解析

単純なテストスイートの作成
この例では、テストをテストスイートに組み込む方法を示します。これらは、パッケージとクラス、ファイルとフォルダー、あるいはその両方で編成されます。
さまざまなワークフローでのテスト実行
テストを実行するさまざまな方法を確認します。
Run Tests Using Test Browser
Run your tests interactively by using the test browser. (R2023a 以降)
エディターでのテストの実行
エディターまたはライブエディターで作業中にテストを実行する。
テストケースの結果の解析
この例では、テストランナーによって返された情報を解析する方法を示します。
失敗したテスト結果の解析
以下の例では、失敗したテストを特定し、それを処理する方法を示します。
失敗したテストの再実行
失敗したテストを素早く便利な方法で再実行する。
動的にフィルター処理されたテスト
仮定エラーでは、テストのエラーは生成されず、Incomplete とマークされたフィルター処理済みのテストが生成されます。実行されないテストコードを回避するには、フィルター処理されたテストを監視します。
テスト診断へのプログラムによるアクセス
テストフレームワークによってテスト結果に記録される診断にプログラムでアクセスする。
テストランナーへのプラグインの追加
この例では、プラグインをテストランナーに追加する方法を説明します。
Types of Code Coverage for MATLAB Source Code
Use different types of code coverage to analyze your MATLAB source code.
MATLAB ソースコードのステートメントおよび関数のカバレッジメトリクスの収集
MATLAB ソースコードのステートメントおよび関数のカバレッジに関する情報を収集して解析する。
MATLAB ユニットテストのコンパイル
MATLAB がインストールされていないターゲットマシン上でテストを実行するために、スタンドアロンアプリケーションを作成する。

クラス ベースのユニット テスト

アプリ

関数

クラス