エディターでのテストの実行

関数ベースのテストファイルを MATLAB^® エディターまたはライブエディターで開くか、クラスベースのテストファイルをエディターで開くと、ファイル内のすべてのテストまたはカーソル位置のテストを対話的に実行できます。この例では、エディターまたはライブエディターでの作業中にテストを実行する方法を説明します。

現在のフォルダーに、sampleTest.m (または sampleTest.mlx) という名前の関数ベースのテストファイルを作成します。

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

function testA(testCase)
verifyEqual(testCase,2+3,5)
end

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

function testC(testCase)
verifySubstring(testCase,"Hello World!","llo")
end

テストファイルを保存すると、[エディター] (または [ライブエディター]) タブの [実行] セクションが変わり、ファイル内のテストを実行できるようになります。

Run section in the Editor or Live Editor tab

[テストの実行] アイコンをクリックします。MATLAB により、ファイル内のすべてのテストがテストブラウザーに追加されて実行されます。コマンドウィンドウではテスト実行の進行状況が表示されます。この例では、すべてのテストがパスします。

Running sampleTest
...
Done sampleTest
__________

ここで、カーソルを関数 testB に置いて [現在のテストを実行] をクリックします。MATLAB はテストブラウザーに testB のみを含めて実行します。

Running sampleTest
.
Done sampleTest
__________

テストの実行に加えて、[テストの実行] の下にあるテストオプションを使用してテストの実行をカスタマイズできます。テストオプションの完全なリストにアクセスするには、[テストの実行] の下のドロップダウン矢印をクリックし、[テストの実行をカスタマイズ] をクリックします。MATLAB は、ファイル内のすべてのテストを実行する場合も、カーソル位置にあるテストだけを実行する場合も、選択されたテストオプションを使用します。

テストオプション	説明
テストを実行する前に出力をクリア	テストを実行する前にコマンドウィンドウの表示内容をクリアします。この選択は、現在の MATLAB セッションの期間中保持されます。
厳密	テストの実行時に厳密なチェックを適用します。たとえば、テストで警告が発行されると、フレームワークで検定エラーが生成されます。この選択は、複数の MATLAB セッション間で保持されます。このオプションを選択することは、`runtests` の名前と値の引数 `Strict` を `true` に指定することと同じです。
並列	テストを並列実行します。このオプションは Parallel Computing Toolbox™ がインストールされている場合にのみ使用できます。この選択は、現在の MATLAB セッションの期間中保持されます。このオプションを選択することは、`runtests` の名前と値の引数 `UseParallel` を `true` に指定することと同じです。
デバッグ	テストの実行時にデバッグ機能を適用します。たとえば、テストの失敗またはキャッチされないエラーが検出された場合、フレームワークはテストの実行を一時停止しデバッグモードに切り替わります。この選択は、現在の MATLAB セッションの期間中保持されます。このオプションを選択することは、`runtests` の名前と値の引数 `Debug` を `true` に指定することと同じです。
出力の詳細	テストの実行で表示される出力の詳細情報の量を制御します。この選択は、複数の MATLAB セッション間で保持されます。このオプションの値を選択することは、`runtests` の名前と値の引数 `OutputDetail` をその値に指定することと同じです。
ログレベル	`log (TestCase)` メソッドおよび `log (Fixture)` メソッドでログに記録される診断を、指定された詳細レベル以下で表示します。この選択は、複数の MATLAB セッション間で保持されます。このオプションの値を選択することは、`runtests` の名前と値の引数 `LoggingLevel` をその値に指定することと同じです。

メモ

[厳密]、[並列]、[出力の詳細]、および [ログレベル] の各オプションは、[エディター] (または [ライブエディター]) タブの [実行] セクションおよびテストブラウザーツールバーで同期されます。これらのインターフェイスのいずれかでオプションを選択すると、その選択内容が他のインターフェイスにも適用されます。たとえば、テストブラウザーで並列テスト実行を有効にすると、MATLAB はツールストリップの [実行] セクションで並列テストオプションを自動的に選択します。

エディターでのテストの実行

参考

アプリ

関数

関連するトピック