reportFinalizedSuite

类： matlab.unittest.plugins.TestRunnerPlugin
包： matlab.unittest.plugins

扩展为最终化的 TestSuite 数组生成的报告

自 R2019b 起

语法

reportFinalizedSuite(plugin,pluginData)

说明

reportFinalizedSuite(plugin,pluginData) 扩展为原始测试套件的最终化部分生成的报告。当不再有验证可能修改与某测试套件部分的元素相关联的结果时，表示该部分是最终化的。测试框架计算此方法的次数与整个 TestSuite 数组划分成的组数相同。

举例来说，在并行运行测试的情形中，就会先为已最终化的报告测试套件部分生成测试结果报告（需要 Parallel Computing Toolbox™）。在这种情况下，测试框架将原始 TestSuite 数组分成不同组，并将这些组分配给当前并行池中的工作进程。覆盖 reportFinalizedSuite 方法的插件可以在工作进程完成测试组后立即报告相应结果，而不是等到整个测试套件完成后再报告。

输入参数

全部展开

`plugin` — 插件对象
`matlab.unittest.plugins.TestRunnerPlugin` 对象

插件对象，指定为 matlab.unittest.plugins.TestRunnerPlugin 类的实例。

`pluginData` — 最终化测试套件部分的信息
`matlab.unittest.plugins.plugindata.FinalizedSuitePluginData` 对象

最终化测试套件部分的信息，指定为 matlab.unittest.plugins.plugindata.FinalizedSuitePluginData 类的实例。测试框架使用此信息来描述该插件的测试内容。

示例

全部展开

显示最终化测试套件的信息

覆盖插件类中的 reportFinalizedSuite 方法，以便在一组测试最终化后显示该组测试的摘要。

classdef ExamplePlugin < matlab.unittest.plugins.TestRunnerPlugin
    methods (Access = protected)
        function reportFinalizedSuite(plugin, pluginData)
            
            % Inspect pluginData to get finalized TestSuite information
            groupNumber = pluginData.Group;
            totalGroups = pluginData.NumGroups;
            suiteSize = numel(pluginData.TestSuite);
            fprintf('### Finished Running %d tests in group %d out of %d groups\n',...
                suiteSize, groupNumber, totalGroups)
            
            % Invoke the superclass method  
            reportFinalizedSuite@matlab.unittest.plugins.TestRunnerPlugin(plugin, pluginData);
        end
    end
end