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

R2026b

関数ベースのテストファイルを 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 Tests section on the Editor or Live Editor tab

[テストの実行] セクションでをクリックします。MATLAB により、テストの実行に使用されるコマンドがコマンドウィンドウに表示され、テストが [テストブラウザー] に追加されて、実行されます。この例では、すべてのテストがパスします。

>> runtests("sampleTest","UseTestBrowser",true)
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.32401 seconds testing time.

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

>> runtests("sampleTest","ProcedureName","testB","UseTestBrowser",true)
Running sampleTest
.
Done sampleTest
__________


ans = 

  TestResult with properties:

          Name: 'sampleTest/testB'
        Passed: 1
        Failed: 0
    Incomplete: 0
      Duration: 0.0037
       Details: [1×1 struct]

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

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

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

メモ

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

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

参考

アプリ

関数

トピック