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

関数ベースあるいはクラスベースのテストファイルを MATLAB^® エディターで開くと、ファイル内のテストをすべて実行するオプションと、カーソル位置のテストを実行するオプションが表示されます (この機能は、関数ベースのテストファイルをライブエディターで開いた場合にも使用できます)。この例では、エディターでの作業中にテストを実行する方法を説明します。

エディターで、sampleTest.m という名前のファイルにテストを作成します。

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

function testA(testCase)
    verifyEqual(testCase,5,5)
end

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

function testC(testCase)
    verifySubstring(testCase,'hello, world','llo')
end

テストを保存すると、[エディター] タブの [実行] セクションが [テストの実行] に変わります。

Run Tests section in the Editor tab

[テストの実行] アイコンをクリックします。MATLAB のコマンドウィンドウに、テストの実行に使用するコマンドが表示され、続いてテストの出力が表示されます。MATLAB は sampleTest.m からの 3 つのテストをすべて実行します。

runtests('sampleTest')

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.0071673 seconds testing time.

エディターで、カーソルを関数 testB に置いて [現在のテストを実行] をクリックします。MATLAB が testB だけを実行します。

runtests('sampleTest','ProcedureName','testB')

Running sampleTest
.
Done sampleTest
__________


ans = 

  TestResult with properties:

          Name: 'sampleTest/testB'
        Passed: 1
        Failed: 0
    Incomplete: 0
      Duration: 9.9411e-04
       Details: [1×1 struct]

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

テストの実行に加えて、[テストの実行] の下にあるテストオプションを使用してテストの実行をカスタマイズできます (オプションの完全なリストにアクセスするには [テストの実行] の下の下向き矢印をクリック)。MATLAB は、ファイル内のすべてのテストを実行するか、カーソル位置にあるテストだけを実行するか、どちらかのテストオプションを使用します。テストオプションを選択すると、選択内容は現在の MATLAB セッションの期間中保持されます。

テストオプション	説明
テストを実行する前に出力をクリア	テストを実行する前にコマンドウィンドウの表示内容をクリアします。
厳密	テストの実行中に厳密なチェックを適用します。たとえば、テストで警告が発行されると、フレームワークで検定エラーが生成されます。このオプションを選択して実行されたテストは、`runtests` の `'Strict'` オプションが `true` に設定されます。
並列	テストを並列実行します。このオプションは Parallel Computing Toolbox™ がインストールされている場合にのみ使用できます。このオプションを選択して実行されたテストは、`runtests` の `'UseParallel'` オプションが `true` に設定されます。
出力の詳細	テストの実行で表示される詳細情報の量を制御します。たとえば、[出力の詳細] が [0: なし] の指定で実行されたテストは、`runtests` の `'OutputDetail'` オプションが 0 に設定されます。
ログレベル	`log` メソッドでログに記録される診断を、指定された詳細レベル以下で表示します。たとえば、[ログレベル] が [3: 詳細] の指定で実行されたテストは、`runtests` の `'LoggingLevel'` オプションが 3 に設定されます。

.mlx 拡張子付きのファイルに保存し、[ライブエディター] タブの [実行] セクションを使用することにより、この例のテストをライブエディターで実行することもできます。

Run section in the Live Editor tab

参考

runtests