teardown

クラス: matlab.unittest.fixtures.Fixture
名前空間: matlab.unittest.fixtures

フィクスチャの破棄

構文

teardown(fixture)

説明

teardown(fixture) は、テスト フレームワークでフィクスチャを破棄するときに環境を元の状態に復元します。

破棄コードを指定するには、このメソッドを Fixture サブクラスで実装します。代わりに、setup メソッド内で addTeardown メソッドを呼び出すこともできます。

入力引数

fixture — フィクスチャ

matlab.unittest.fixtures.Fixture オブジェクト

フィクスチャ。matlab.unittest.fixtures.Fixture オブジェクトとして指定します。

例

フィクスチャの破棄コードの指定

数値の出力表示形式を小数点以下 2 桁の通貨形式に変更するカスタム フィクスチャを作成して使用します。

現在のフォルダー内の CurrencyFormatFixture.m という名前のファイルで、matlab.unittest.fixtures.Fixture インターフェイスをサブクラス化して CurrencyFormatFixture クラスを作成します。次の要素をクラスに追加します。

• OriginalFormat プロパティ — このプロパティを追加して、元の表示形式を記録し、この情報を必要とするメソッドに渡します。

• setup メソッド — このメソッドを実装して、フィクスチャによって数値の表示形式が通貨形式に変更されるようにします。

• teardown メソッド — このメソッドを実装して、テスト後にフィクスチャによって表示形式が元の状態に戻されるようにします。

classdef CurrencyFormatFixture < matlab.unittest.fixtures.Fixture
    properties (Access=private)
        OriginalFormat
    end

    methods
        function setup(fixture)
            fixture.OriginalFormat = format;
            format bank
        end

        function teardown(fixture)
            format(fixture.OriginalFormat)
        end
    end
end

現在のフォルダー内の ExampleTest.m という名前のファイルで、カスタム フィクスチャを適用し、数値が想定される形式で表示されることを検証する ExampleTest クラスを作成します。この例では、簡略化するために、関数 formattedDisplayText の呼び出しで実際の値を生成しています。実際には、ユーザー定義のコードをテストします。

classdef ExampleTest < matlab.unittest.TestCase
    methods (Test)
        function formatTest(testCase)
            testCase.applyFixture(CurrencyFormatFixture)
            actual = strtrim(formattedDisplayText(pi));
            expected = "3.14";
            testCase.verifyEqual(actual,expected)
        end
    end
end

ExampleTest クラスを実行します。テスト フレームワークでフィクスチャがセットアップされ、表示形式が通貨形式に変更されます。テストの実行が完了すると、フレームワークでフィクスチャが破棄され、元の表示形式に戻ります。この例では、テストはパスします。

runtests("ExampleTest");

Running ExampleTest
.
Done ExampleTest
__________

ヒント

• teardown メソッドは、フィクスチャを破棄するときにテスト フレームワークでのみ呼び出されます。このメソッドをコードで直接呼び出すことはできません。teardown で破棄アクションを実行するには、applyFixture メソッドを呼び出してフィクスチャを使用します。

バージョン履歴

R2014a で導入

参考

setup | addTeardown | format

トピック

• 基本的なカスタム フィクスチャの作成
• 高度なカスタム フィクスチャの作成