最新のリリースでは、このページがまだ翻訳されていません。このページの最新版は英語でご覧になれます。

matlab.unittest.TestCase クラス

パッケージ: matlab.unittest

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

説明

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

構築

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

メソッド

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

継承メソッド

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

matlab.unittest.qualifications.Assertable	テストの前提条件を検証する検定
matlab.unittest.qualifications.Assumable	テストの内容をフィルター処理する検定
matlab.unittest.qualifications.FatalAssertable	テストの実行を中断する検定
matlab.unittest.qualifications.Verifiable	ソフトエラー条件を生成する検定

属性

クラスの属性

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 回はテストメソッドが呼び出されます。
`TestTags`	指定された値のタグが付いているテストを含むメソッドブロック。`TestTags` は、空でない文字ベクトルの cell 配列、または空でない string の配列として定義しなければなりません。ここで各要素がテスト用のタグになります。

プロパティの属性

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

`ClassSetupParameter`	`TestClassSetup` ブロックでメソッドのパラメーター化されたテストプロパティを定義するプロパティブロック
`MethodSetupParameter`	`MethodSetup` ブロックでメソッドのパラメーター化されたテストプロパティを定義するプロパティブロック
`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

参考

トピック

R2013a で導入

matlab.unittest.TestCase クラス

説明

構築