本教程详细介绍了如何在Serenity框架中使用JUnit 5的`@RepeatedTest`注解，实现Selenium测试用例的重复执行。通过集成`serenity-junit5`扩展，开发者可以轻松地将单个测试方法运行指定次数，从而有效进行稳定性验证或特定场景的多次模拟，提升测试效率和覆盖度。
在自动化测试实践中，有时我们需要对同一个测试用例进行多次重复执行。这可能出于多种目的，例如验证应用的稳定性、模拟高并发下的行为（尽管这并非负载测试的最佳实践）、或者在数据驱动测试中模拟不同数据集的多次输入。对于使用Serenity框架结合Selenium进行Web自动化测试的场景，JUnit 5提供了一个简洁而强大的机制来实现这一需求：@RepeatedTest注解。
Serenity与JUnit 5的集成基础
Serenity框架通过其serenity-junit5扩展，与JUnit 5测试框架无缝集成。这意味着我们可以直接利用JUnit 5的各项高级特性，包括参数化测试、动态测试以及本教程关注的重复测试。
要实现测试的重复执行，核心步骤是：
- 确保项目中已引入serenity-junit5依赖。
- 在测试类上使用@ExtendWith(SerenityJUnit5Extension.class)注解，以启用Serenity的JUnit 5扩展。
- 在需要重复执行的测试方法上，使用@RepeatedTest(n)注解，其中n是你希望测试运行的次数。
实现Selenium测试重复执行的示例
以下是一个具体的代码示例，演示如何在一个Serenity驱动的Selenium测试中，将访问Google页面的操作重复执行两次：
import net.serenitybdd.junit5.SerenityJUnit5Extension;
import net.thucydides.core.annotations.Managed;
import org.junit.jupiter.api.RepeatedTest;
import org.junit.jupiter.api.extension.ExtendWith;
import org.openqa.selenium.WebDriver;
/**
* 演示如何在Serenity框架下使用JUnit 5的@RepeatedTest注解
* 重复执行Selenium测试。
*/
@ExtendWith(SerenityJUnit5Extension.class)
public class GoToGoogleRepeatedTest {
// Serenity自动管理WebDriver实例
@Managed
WebDriver driver;
/**
* 该测试方法将被重复执行指定次数。
* 在本例中，它将重复执行2次。
*/
@RepeatedTest(2)
void accessGoogleHomepageRepeatedly() {
System.out.println("正在执行访问Google主页的测试...");
driver.get("https://google.com");
// 这里可以添加更多的断言或交互逻辑
// 例如：Assertions.assertTrue(driver.getTitle().contains("Google"));
}
}代码解析
- import net.serenitybdd.junit5.SerenityJUnit5Extension;: 导入Serenity JUnit 5扩展类。
- import net.thucydides.core.annotations.Managed;: 导入Serenity的@Managed注解，用于声明并自动管理WebDriver实例。
- import org.junit.jupiter.api.RepeatedTest;: 导入JUnit 5的@RepeatedTest注解。
- import org.junit.jupiter.api.extension.ExtendWith;: 导入JUnit 5的@ExtendWith注解，用于注册扩展。
- @ExtendWith(SerenityJUnit5Extension.class): 这个注解告诉JUnit 5，在执行此类中的测试时，需要加载并使用SerenityJUnit5Extension。这是Serenity框架能够管理WebDriver、生成报告等功能的关键。
- @Managed WebDriver driver;: Serenity框架会负责初始化和关闭这个WebDriver实例。对于每次重复执行的测试，Serenity通常会提供一个全新的WebDriver实例，确保测试之间的隔离性。
- @RepeatedTest(2): 这是实现重复执行的核心。它指示JUnit 5将accessGoogleHomepageRepeatedly()方法执行两次。你可以将2替换为任何你需要的重复次数。
注意事项与最佳实践
- 测试隔离性：Serenity框架通常会确保每次重复执行的测试都运行在一个相对独立的上下文中，包括独立的WebDriver实例。这有助于避免测试之间的状态污染。
- 报告生成：Serenity会为每一次重复执行的测试生成独立的报告条目，清晰地展示每次运行的结果，包括通过、失败或跳过。
-
何时使用@RepeatedTest：
- 稳定性验证：检查在多次运行后，测试是否仍然能够稳定通过，发现间歇性失败（flaky tests）。
- 特定场景的多次模拟：例如，测试一个需要多次尝试才能成功的操作，或者验证一个随机生成数据的场景。
- 避免用于负载测试：@RepeatedTest并非为高并发或大规模负载测试设计。对于这类需求，应使用专门的性能测试工具（如JMeter、Gatling等）。
-
RepetitionInfo参数：@RepeatedTest还可以与RepetitionInfo参数结合使用，以获取当前重复的次数和总重复次数，这在需要根据当前是第几次重复来调整测试行为时非常有用。例如：
import org.junit.jupiter.api.RepetitionInfo; // ... @RepeatedTest(5) void testWithRepetitionInfo(RepetitionInfo repetitionInfo) { System.out.println("当前是第 " + repetitionInfo.getCurrentRepetition() + " 次重复，总共 " + repetitionInfo.getTotalRepetitions() + " 次。"); driver.get("https://another-site.com/" + repetitionInfo.getCurrentRepetition()); }
总结
通过Serenity框架与JUnit 5的强大结合，开发者可以轻松地实现Selenium测试用例的重复执行。@RepeatedTest注解提供了一种简洁高效的方式来增强测试的鲁棒性和覆盖范围，尤其适用于稳定性验证和特定场景的多次模拟。正确地运用这一特性，能够显著提升自动化测试的价值和效率。
