Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

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

関数ベースあるいはクラスベースのテスト ファイルを 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

参考