matlab.unittest.TestCase クラス

パッケージ: matlab.unittest

すべての matlab.unittest テストクラスのスーパークラス

説明

この TestCase クラスはを matlab.unittest フレームワークに書き込むための手段です。このクラスによって、テストの内容、テストのフィクスチャのセットアップ、破棄ルーチンの書き込みと特定を行うことができます。このようなテストを作成するには、TestCase から導出して TestCase サブクラスを生成する必要があります。次にサブクラスでメタデータ属性を利用して、テストおよびテストのフィクスチャを指定することができます。

構築

forInteractiveUse 静的メソッドを使用して、対話型のコマンドライン用の TestCase を作成します。フレームワークでテストを実行する場合、TestCase インスタンスは matlab.unittest.TestRunner によって作成されます。

メソッド

addTeardown	破棄ルーチンを `TestCase` インスタンスに動的に追加
applyFixture	`TestCase` でのフィクスチャの使用
createTemporaryFolder	Create temporary folder
forInteractiveUse	対話型で使用する TestCase を作成
getSharedTestFixtures	共有テストフィクスチャへのアクセスの提供
log	テスト実行中の診断情報の記録
onFailure	テスト失敗の診断情報を動的に追加
run	`TestCase` テストを実行する

継承メソッド

TestCase クラスは、以下のクラスからメソッドを継承します。

属性

クラスの属性

TestCase オブジェクトは以下のクラスレベルの属性をサポートします。クラスレベルの属性は、classdef ブロックでクラス名の前に指定します。

`SharedTestFixtures`	共有テストフィクスチャを含めるためのクラスブロック。`matlab.unittest.fixtures.Fixture` インスタンスの cell 配列として `SharedTestFixtures` を定義しなければなりません。
`TestTags`	指定された値のタグが付いているテストを含むクラスブロック。`TestTags` は、空でない文字ベクトルの cell 配列、または空でない string の配列として定義しなければなりません。ここで各要素がテスト用のタグになります。

メソッドの属性

TestCase から導出されるクラスは、matlab.unittest フレームワーク固有の属性を含む methods ブロックを定義しての内容を指定することができます。

`Test`	テストメソッドを含めるためのメソッドブロック。
`TestMethodSetup`	セットアップコードを含めるためのメソッドブロック。
`TestMethodTeardown`	破棄コードを含めるためのメソッドブロック。
`TestClassSetup`	クラスレベルのセットアップコードを含めるためのメソッドブロック。
`TestClassTeardown`	クラスレベルの破棄コードを含めるためのメソッドブロック。
`ParameterCombination`	パラメーター化されたテストコードを含めるためのメソッドブロック。この属性は、次の値を受け入れます。 `'exhaustive'` (既定の設定): すべてのパラメーターの組み合わせについてテストメソッドが呼び出されます。 `'sequential'`:各パラメーターの対応する値でテストメソッドが呼び出されます。各パラメーターには、同じ数の値が含まれていなければなりません。 `'pairwise'`:パラメーター値の各ペアについて少なくとも 1 回はテストメソッドが呼び出されます。
`TestParameterDefinition`	スイートの作成時にパラメーター化プロパティを初期化するコードを含めるためのメソッドブロック。この属性を使用して定義されるメソッドは静的でなければなりません。
`TestTags`	指定された値のタグが付いているテストを含むメソッドブロック。`TestTags` は、空でない文字ベクトルの cell 配列、または空でない string の配列として定義しなければなりません。ここで各要素がテスト用のタグになります。

プロパティの属性

TestCase から導出されるクラスは、matlab.unittest フレームワーク固有の属性を含む properties ブロックを定義しての内容を指定することができます。

`ClassSetupParameter`	`TestClassSetup` ブロックのメソッドのパラメーター化プロパティを定義するプロパティブロック。
`MethodSetupParameter`	`TestMethodSetup` ブロックのメソッドのパラメーター化プロパティを定義するプロパティブロック。
`TestParameter`	`Test` ブロックのメソッドのパラメーター化プロパティを定義するプロパティブロック。

イベント

`VerificationFailed`	検証の失敗時にトリガーされます。`QualificationEventData` オブジェクトがリスナーコールバック関数に渡されます。‎
`VerificationPassed`	検証の成功時にトリガーされます。`QualificationEventData` オブジェクトがリスナーコールバック関数に渡されます。
`AssertionFailed`	アサーションの失敗時にトリガーされます。`QualificationEventData` オブジェクトがリスナーコールバック関数に渡されます。
`AssertionPassed`	アサーションの成功時にトリガーされます。`QualificationEventData` オブジェクトがリスナーコールバック関数に渡されます。
`FatalAssertionFailed`	致命的なアサーションの失敗時にトリガーされます。`QualificationEventData` オブジェクトがリスナーコールバック関数に渡されます。‎
`FatalAssertionPassed`	致命的なアサーションの成功時にトリガーされます。`QualificationEventData` オブジェクトがリスナーコールバック関数に渡されます。‎
`AssumptionFailed`	仮定の失敗時にトリガーされます。`QualificationEventData` オブジェクトがリスナーコールバック関数に渡されます。‎
`AssumptionPassed`	仮定の成功時にトリガーされます。`QualificationEventData` オブジェクトがリスナーコールバック関数に渡されます。‎
`ExceptionThrown`	例外がスローされたときに `TestRunner` によりトリガーされます。`ExceptionEventData` オブジェクトがリスナーコールバック関数に渡されます。
`DiagnosticLogged`	`log` メソッドを呼び出したときに `TestRunner` によりトリガーされます。`LoggedDiagnosticEventData` オブジェクトがリスナーコールバック関数に渡されます。

例

すべて折りたたむ

テストケースクラスの作成

TestMethodSetup および TestMethodTeardown メソッドを使って、テストケースクラス FigurePropertiesTest を作成します。

classdef FigurePropertiesTest < matlab.unittest.TestCase
 
    properties
        TestFigure
    end
 
    methods(TestMethodSetup)
        function createFigure(testCase)
            testCase.TestFigure = figure;
        end
    end
 
    methods(TestMethodTeardown)
        function closeFigure(testCase)
            close(testCase.TestFigure)
        end
    end
 
    methods(Test)
 
        function defaultCurrentPoint(testCase)
 
            cp = testCase.TestFigure.CurrentPoint;
            testCase.verifyEqual(cp, [0 0], ...
                'Default current point is incorrect')
        end
 
        function defaultCurrentObject(testCase)
            import matlab.unittest.constraints.IsEmpty
 
            co = testCase.TestFigure.CurrentObject;
            testCase.verifyThat(co, IsEmpty, ...
                'Default current object should be empty')
        end
 
    end
 
end

ヒント

TestCase サブクラスでコンストラクターメソッドまたはデストラクターメソッドを定義することは推奨されません。TestCase のコンストラクターメソッドとデストラクターメソッドはテスト内容と見なされず、検定の実行に使用してはなりません。たとえば、次の SampleTest クラスでは、コンストラクターメソッドと Test メソッドを使用して検定を指定しています。ただし、コンストラクターメソッド内の検定はテストエラーを生成しません。テストフレームワークは、testSize メソッド内で実行される検定の結果として、テストエラーを 1 つしか報告しません。
```
classdef SampleTest < matlab.unittest.TestCase
    methods
        function testCase = SampleTest % Constructor method not recommended
            testCase.verifyEqual(1,2)  % Does not produce a test failure
        end
    end

    methods(Test)
       function testSize(testCase)
           testCase.verifySize([1 2 3; 4 5 6],[2 4]) % Produces a test failure
       end
    end
end
```

バージョン履歴

R2013a で導入

参考