createSharedTestFixture

クラス: matlab.unittest.plugins.TestRunnerPlugin
名前空間: matlab.unittest.plugins

共有テストフィクスチャの作成を拡張する

構文

f = createSharedTestFixture(plugin,pluginData)

説明

f = createSharedTestFixture(plugin,pluginData) は、共有テストフィクスチャの作成を拡張し、変更された Fixture インスタンスを返します。テストフレームワークはフィクスチャを使用して、共有フィクスチャを使用するテストの実行をカスタマイズします。このフレームワークは、セットアップする必要がある共有テストフィクスチャごとに、runTestSuite メソッドのスコープ内でこのメソッドを評価します。

このメソッドの一般的な実装では、共有テストフィクスチャから発生するさまざまなイベントにリスナーを追加します。Fixture クラスは handle クラスから継承するので、createSharedTestFixture メソッドの内部から addlistener メソッドを呼び出して、リスナーを追加します。

入力引数

すべて展開する

`plugin` — プラグイン
`matlab.unittest.plugins.TestRunnerPlugin` オブジェクト

プラグイン。matlab.unittest.plugins.TestRunnerPlugin オブジェクトとして指定します。

`pluginData` — 共有テストフィクスチャ作成情報
`matlab.unittest.plugins.plugindata.TestContentCreationPluginData` オブジェクト

共有テストフィクスチャ作成情報。matlab.unittest.plugins.plugindata.TestContentCreationPluginData オブジェクトとして指定します。テストフレームワークはこの情報を使用してプラグインにテスト内容を記述します。

属性

Access protected

メソッドの属性の詳細については、メソッドの属性を参照してください。

例

すべて展開する

共有テストフィクスチャのアサーションエラーのカウント

プラグインを作成して createSharedTestFixture メソッドをオーバーライドし、共有テストフィクスチャのアサーションエラーの数をカウントします。

アサーションエラーをリッスンするリスナーを追加します。補助メソッド captureFixtureAssertionFailureData を使用して、FixtureAssertionFailureData プロパティに値を取り込みます。

classdef ExamplePlugin < matlab.unittest.plugins.TestRunnerPlugin
    properties (SetAccess=private)
        FixtureAssertionFailureData = {};
    end

    methods (Access=protected)
        function fixture = createSharedTestFixture(plugin,pluginData)
            % Invoke the super class method
            fixture = createSharedTestFixture@ ...
                matlab.unittest.plugins.TestRunnerPlugin(plugin,pluginData);

            % Get the fixture name
            fixtureName = pluginData.Name;

            % Add a listener to fixture assertion failures
            % and capture the qualification failure information
            fixture.addlistener('AssertionFailed',@(~,evd) ...
                plugin.captureFixtureAssertionFailureData(evd,fixtureName))
        end
    end

    methods (Access=private)
        function captureFixtureAssertionFailureData(plugin,eventData,fixtureName)
            plugin.FixtureAssertionFailureData{end+1} = struct( ...
                'FixtureName',fixtureName, ...
                'ActualValue',eventData.ActualValue, ...
                'Constraint' ,eventData.Constraint, ...
                'Stack'      ,eventData.Stack);
        end
    end
end