Selenium：HTML测试报告完全指南

<!-- Selenium Java -->
<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.14.1</version>
</dependency>
 
<!-- TestNG -->
<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>7.8.0</version>
    <scope>test</scope>
</dependency>
 
<!-- Extent Reports -->
<dependency>
    <groupId>com.aventstack</groupId>
    <artifactId>extentreports</artifactId>
    <version>5.0.9</version>
</dependency>

import com.aventstack.extentreports.ExtentReports;
import com.aventstack.extentreports.ExtentTest;
import com.aventstack.extentreports.reporter.ExtentSparkReporter;
import org.openqa.selenium.OutputType;
import org.openqa.selenium.TakesScreenshot;
import org.openqa.selenium.WebDriver;
import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.text.SimpleDateFormat;
import java.util.Date;
 
public class ExtentReportManager {
    private static ExtentReports extent;
    private static ThreadLocal<ExtentTest> test = new ThreadLocal<>(); // 线程安全的用例对象
 
    // 初始化报告
    public static ExtentReports initReport() {
        if (extent == null) {
            // 指定报告输出路径（按时间戳命名，避免覆盖）
            String timestamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
            String reportPath = System.getProperty("user.dir") + "/test-output/ExtentReport_" + timestamp + ".html";
            ExtentSparkReporter sparkReporter = new ExtentSparkReporter(reportPath);
            
            // 配置报告标题、主题等
            sparkReporter.config().setReportName("Selenium自动化测试报告");
            sparkReporter.config().setDocumentTitle("Web UI测试结果");
            
            extent = new ExtentReports();
            extent.attachReporter(sparkReporter);
            // 添加环境信息
            extent.setSystemInfo("浏览器", "Chrome 118.0");
            extent.setSystemInfo("操作系统", "Windows 10");
            extent.setSystemInfo("Selenium版本", "4.14.1");
        }
        return extent;
    }
 
    // 创建测试用例
    public static ExtentTest createTest(String testName, String description) {
        ExtentTest extentTest = extent.createTest(testName, description);
        test.set(extentTest);
        return extentTest;
    }
 
    // 记录测试步骤日志
    public static void logInfo(String message) {
        test.get().info(message);
    }
 
    // 附加截图（失败时调用）
    public static void attachScreenshot(WebDriver driver, String screenshotName) {
        try {
            TakesScreenshot ts = (TakesScreenshot) driver;
            File source = ts.getScreenshotAs(OutputType.FILE);
            String destPath = System.getProperty("user.dir") + "/screenshots/" + screenshotName + ".png";
            Files.copy(source.toPath(), Paths.get(destPath));
            // 将截图附加到报告中
            test.get().addScreenCaptureFromPath(destPath, screenshotName);
        } catch (IOException e) {
            test.get().fail("截图失败：" + e.getMessage());
        }
    }
 
    // 结束报告（必须调用，否则报告不生成）
    public static void flushReport() {
        if (extent != null) {
            extent.flush();
        }
    }
}

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.Assert;
import org.testng.ITestResult;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.AfterSuite;
import org.testng.annotations.BeforeMethod;
import org.testng.annotations.Test;
import io.github.bonigarcia.wdm.WebDriverManager;
 
public class BaiduSearchTest {
    private WebDriver driver;
 
    @BeforeMethod
    public void setup() {
        WebDriverManager.chromedriver().setup(); // 自动管理ChromeDriver
        driver = new ChromeDriver();
        driver.manage().window().maximize();
        ExtentReportManager.initReport(); // 初始化报告
    }
 
    @Test(description = "验证百度搜索功能")
    public void testBaiduSearch() {
        // 创建测试用例
        ExtentReportManager.createTest("百度搜索测试", "搜索关键词并验证结果");
        
        // 步骤1：打开百度首页
        driver.get("https://www.baidu.com");
        ExtentReportManager.logInfo("打开百度首页：https://www.baidu.com");
        
        // 步骤2：输入搜索关键词
        driver.findElement(By.id("kw")).sendKeys("Selenium HTML报告");
        ExtentReportManager.logInfo("输入搜索关键词：Selenium HTML报告");
        
        // 步骤3：点击搜索按钮
        driver.findElement(By.id("su")).click();
        ExtentReportManager.logInfo("点击搜索按钮");
        
        // 步骤4：验证结果页标题
        String actualTitle = driver.getTitle();
        String expectedTitle = "Selenium HTML报告_百度搜索";
        ExtentReportManager.logInfo("验证结果页标题：预期=" + expectedTitle + "，实际=" + actualTitle);
        Assert.assertEquals(actualTitle, expectedTitle, "搜索结果标题不匹配");
    }
 
    @AfterMethod
    public void teardown(ITestResult result) {
        // 若测试失败，附加截图
        if (result.getStatus() == ITestResult.FAILURE) {
            ExtentReportManager.attachScreenshot(driver, "失败截图_" + result.getName());
            ExtentReportManager.logInfo("测试失败：" + result.getThrowable().getMessage());
        }
        driver.quit();
    }
 
    @AfterSuite
    public void afterSuite() {
        ExtentReportManager.flushReport(); // 生成报告
    }
}