重复测试

JUnit Jupiter通过使用@RepeatedTest注解方法并指定所需的重复次数,提供了重复测试指定次数的功能。每次重复测试的调用都像执行常规的@Test方法一样,完全支持相同的生命周期回调和扩展。

以下示例演示了如何声明名为repeatedTest()的测试,该测试将自动重复10次。

@RepeatedTest(10)
void repeatedTest() {
    // ...
}

除了指定重复次数外,还可以通过@RepeatedTest注解的name属性为每次重复配置自定义显示名称。此外,显示名称可以是模式,由静态文本和动态占位符的组合而成。目前支持以下占位符:

  • {displayName}: @RepeatedTest方法的显示名称

  • {currentRepetition}: 当前重复次数

  • {totalRepetitions}: 重复的总次数

给定重复的默认显示名称基于以下模式生成:"repetition {currentRepetition} of {totalRepetitions}"。 因此,前面的repeatedTest()示例的单个重复的显示名称将是:repetition 1 of 10, repetition 2 of 10等等。如果您希望每个重复的名称中包含@RepeatedTest方法的显示名称,您可以定义自己的自定义模式或使用预定义的RepeatedTest.LONG_DISPLAY_NAME模式。后者相当于"{displayName} :: repetition {currentRepetition} of {totalRepetitions}",这会导致重复测试的显示名称变成这样:repeatedTest() :: repetition 1 of 10, repeatedTest() :: repetition 2 of 10等。

为了以编程方式获取有关当前重复和总重复次数的信息,开发人员可以选择将RepetitionInfo的实例注入@RepeatedTest@BeforeEach@AfterEach方法。

重复测试示例

本节末尾的RepeatedTestsDemo类将演示重复测试的几个示例。

repeatedTest()方法与上一节中的示例相同; 而repeatedTestWithRepetitionInfo()演示了如何将RepetitionInfo的实例注入到测试中,以获取当前重复测试的总重复次数。

接下来的两个方法演示了如何在每个重复的显示名称中包含@RepeatedTest方法的自定义@DisplayNamecustomDisplayName()用自定义模式组合自定义显示名称,然后使用TestInfo来验证生成的显示名称的格式。Repeat!是来自@DisplayName,来自{displayName}声明,1/1来自{currentRepetition}/{totalRepetitions}。相反,customDisplayNameWithLongPattern()使用前面提到的预定义的RepeatedTest.LONG_DISPLAY_NAME模式。

repeatedTestInGerman()展示了将重复测试的显示名称翻译成外语的能力 - 在这种情况下是德语,从而得到单个重复的名称,例如:Wiederholung 1 von 5Wiederholung 2 von 5等。

由于beforeEach()方法用@BeforeEach标注,所以在每次重复测试之前都会执行它。通过将TestInfoRepetitionInfo注入到方法中,我们可以看到,有可能获得有关当前正在执行的重复测试的信息。在启用了INFO日志级别的情况下,执行RepeatedTestsDemo会得到以下输出。

在启用了unicode主题的情况下,使用ConsoleLauncherjunitPlatformTest Gradle插件时,执行RepeatedTestsDemo会将以下输出给控制台。

Last updated