编写插件以扩展 TestRunner

自定义插件概述

TestRunnerPlugin 方法有四个级别：测试会话、测试套件、测试类和测试。在每个级别，您都可以实现方法来扩展测试运行。此外，您可以在测试套件、测试类和测试级别实现方法，以扩展测试或测试脚手架的创建、设置和拆解。

在测试套件、测试类和测试级别，reportFinalizedResult 方法使用测试运行器报告最终测试结果。当没有其余的测试内容可以修改测试结果时，表示测试结果已最终确定。测试运行器会确定它是否在每个级别都调用 reportFinalizedResult 方法。在测试会话级别，reportFinalizedSuite 方法使用测试运行器在测试套件最终确定后报告测试结果。

测试运行器运行不同方法，如下图所示。

创建方法是唯一包含输出参量的 TestRunnerPlugin 方法集。通常，可扩展创建方法以在对应级别侦听源自测试内容的各种事件。因为 TestCase 和 Fixture 实例均继承自 handle 类，所以可以使用 addlistener 方法添加侦听程序。设置、运行和拆解测试内容的方法可扩展测试运行器评估测试内容的方式。

扩展测试会话级别插件方法

测试会话级别的 TestRunnerPlugin 方法可扩展传递给测试运行器的测试套件的运行和报告。下列方法属于 runSession 方法的范围。

此级别的运行方法 runTestSuite 可扩展测试框架传递给测试运行器的整个 TestSuite 数组的一部分的运行。reportFinalizedSuite 方法可扩展 runTestSuite 最终确定的测试套件的报告。

扩展测试套件级别插件方法

测试套件级别的 TestRunnerPlugin 方法扩展共享测试脚手架的创建、设置、运行和拆解。下列方法属于 runTestSuite 方法的范围。

在此级别，createSharedTestFixture 方法是唯一带输出参量的插件方法。它为测试类所需的每个共享脚手架返回 Fixture 实例。这些 Fixture 实例可通过 TestCase 的 getSharedTestFixtures 方法提供给测试。

此级别的运行方法 runTestClass 扩展属于同一测试类的测试或同一基于函数的测试的运行，并纳入为测试类级别插件方法描述的功能。

扩展测试类级别插件方法

测试类级别的 TestRunnerPlugin 方法可扩展属于同一测试类或同一基于函数的测试的测试套件元素的创建、设置、运行和拆解。这些方法适用于测试运行器运行的整个 TestSuite 数组的一部分。

在此级别，createTestClassInstance 方法是唯一带输出参量的插件方法。它返回在类级别创建的 TestCase 实例。对于每个类，测试框架向任何带有 TestClassSetup 或 TestClassTeardown 属性的方法传递该实例。

如果某测试类设置包含带 ClassSetupParameter 特性的属性，则它已被参数化。本例中，测试框架按照类设置参数化的规定评估 setupTestClass 和 teardownTestClass 方法很多次。

此级别的运行方法 runTest 可扩展单个 TestSuite 元素的运行，并纳入为测试级别插件方法描述的功能。

测试框架在 runTestClass 方法范围内对测试类级别的方法进行计算。如果 TestClassSetup 代码成功完成，则它为 TestSuite 数组中的每个元素调用 runTest 方法一次。每个 TestClassSetup 参数化调用创建、设置和拆解方法一次。

扩展测试级别插件方法

测试级别的 TestRunnerPlugin 方法可扩展单个测试套件元素的创建、设置、运行和拆解。单个 Test 元素包括一个 Test 方法，如果测试被参数化，则包括测试参数化的一个实例。

在此级别，createTestMethodInstance 方法是唯一带输出参量的插件方法。它返回为每个 Test 元素创建的 TestCase 实例。测试框架将每个实例传入相应的 Test 方法，以及任何带有 TestMethodSetup 或 TestMethodTeardown 属性的方法。

测试框架在 runTest 方法范围内对测试级别的方法进行计算。框架完成所有 TestMethodSetup 工作后，它为每个 Test 元素调用此级别的插件方法一次。