章节十七、1-高级报告介绍

一、Extent Report 的功能

1、使用写好的API，非常简单。

2、美观的界面。

3、为测试运行结果提供指示板。

4、创建一个单独的报告文件，从而减少对项目文件的管理。

5、分类成单独的部分，按类别提供测试分析。

6、根据测试用例的状态生成饼图。

7、我们可以根据状态筛选报告。

8、它可以获取系统细节，如操作系统、java版本和内存等。

9、可以在报告中附加截图，这是最重要的功能。

10、轻松集成测试--跑日志。

11、可以使用外部配置文件进行大量定制。

二、使用Extent Report首先我们需要下载4下jar文件，然后导入的项目文件中（具体的导入操作我以前的章节中有介绍过）：

1、Extent Reports Version：

https://search.maven.org/search?q=a:extentreports

2、Freemarker Version：

http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.freemarker%22%20AND%2 0a%3A%22freemarker%22

3、Jsoup Version:

http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.jsoup%22%20AND%20a%3 A%22jsoup%22

4、Sqlite-jdbc Version:

http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.xerial%22%20AND%20a%3 A%22sqlite-jdbc%22

三、实例演示

1、网络没有翻墙的话，extent report的CSS加载是有问题的，能生成报告，但报告显示有问题，解决这个问题的办法是：重写ExtentReport这个类。

package extenreports;

import java.io.File;
import java.util.Date;

import com.aventstack.extentreports.ExtentReports;
import com.aventstack.extentreports.ResourceCDN;
import com.aventstack.extentreports.reporter.ExtentHtmlReporter;
import com.aventstack.extentreports.reporter.configuration.ChartLocation;
import com.aventstack.extentreports.reporter.configuration.Theme;

public class ExtentFactory {
    public static ExtentReports getInstance() {

        Date date = new Date();
        String form = String.format("%tF", date);
        String hour = String.format("%tH", date);
        String minute = String.format("%tM", date);
        String second = String.format("%tS", date);
        // 生成的路径以及文件名
        final String OUTPUT_FOLDER = "C:\Users\acer\Desktop\其它\ExtentReports";
        final String FILE_NAME = "index" + form + hour + minute + second + ".html";

        // 文件夹不存在的话进行创建
        File reportDir = new File(OUTPUT_FOLDER);
        if (!reportDir.exists() && !reportDir.isDirectory()) {
            reportDir.mkdir();
        }

        ExtentHtmlReporter htmlReporter = new ExtentHtmlReporter(OUTPUT_FOLDER + FILE_NAME);
        // 设置静态文件的DNS
        htmlReporter.config().setResourceCDN(ResourceCDN.EXTENTREPORTS);
        // 怎么样解决cdn.rawgit.com访问不了的情况
        htmlReporter.config().setResourceCDN(ResourceCDN.EXTENTREPORTS);
        htmlReporter.config().setDocumentTitle("标品页面功能自动化测试报告");
        htmlReporter.config().setReportName("标品冒烟测试--页面功能自动化测试报告");
        htmlReporter.config().setChartVisibilityOnOpen(true);
        htmlReporter.config().setTestViewChartLocation(ChartLocation.TOP);
        htmlReporter.config().setTheme(Theme.STANDARD);
        htmlReporter.config().setCSS(".node.level-1  ul{ display:none;} .node.level-1.active ul{display:block;}");
        htmlReporter.config().setEncoding("gbk");
        ExtentReports extent = new ExtentReports();
        extent.attachReporter(htmlReporter);
        extent.setReportUsesManualConfiguration(true);
        extent.setSystemInfo("Selenium Version", "3.11.0");
        extent.setSystemInfo("Platform", "Windows");

        return extent;
    }
}

注意：

重写ExtentReport遇到包无法导入的问题， com.aventstack.extentreports.ResourceCDN和 com.aventstack.extentreports.reporter.configuration.ChartLocation 我用的是最新的依赖，无法导入这两个包，最后按照网上的方法，改版本号为3.0.6之后就解决 了。

 2、测试案例

package extenreports;

import java.util.concurrent.TimeUnit;
import org.openqa.selenium.By;
import org.openqa.selenium.NoSuchElementException;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.Assert;
import org.testng.annotations.AfterClass;
import org.testng.annotations.BeforeClass;
import org.testng.annotations.Test;

import com.aventstack.extentreports.ExtentReports;
import com.aventstack.extentreports.ExtentTest;
import com.aventstack.extentreports.Status;


public class SeleniumLoginTest {
    
    private WebDriver driver;
    private String baseUrl;
//    使用ExtentReports高级报告，我们需要先声明以下两个变量（需要导入相对应的包，否则会报错）
    ExtentReports reports;
    ExtentTest test;

    @BeforeClass
    public void beforeClass() {
        baseUrl = "https://mail.qq.com";
        //初始化变量
        reports = ExtentFactory.getInstance();
//        括号中填写的是测试的名字
        test = reports.createTest("Verify if login success");
        driver = new ChromeDriver();
//        记录登录的日志信息
        test.log(Status.INFO,"Browser Maxanized ............");
        driver.manage().window().maximize();
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        test.log(Status.INFO,"Browser started ............");
        driver.get(baseUrl);
        test.log(Status.INFO,"Web  Application Open ............");

    }
    
    @Test
    public void test1_validLoginTest() throws Exception {
        driver.switchTo().frame("login_frame");
        
        WebElement dl = driver.findElement(By.className("switch_btn"));
        dl.click();
        
        WebElement emailField = driver.findElement(By.id("u"));
        emailField.sendKeys("1234567890");
        test.log(Status.INFO,"Enter User Name ............");
        
        WebElement passwordField = driver.findElement(By.id("p"));
        passwordField.sendKeys("******");
        test.log(Status.INFO,"Enter Password ............");

        
        WebElement goButton = driver.findElement(By.id("login_button"));
        goButton.click();
        test.log(Status.INFO,"Clicked on login button ............");

        WebElement welcomeText = null;
        
        try {
            welcomeText = driver.findElement(By.xpath("//b[text()='****']"));
        }
        catch (NoSuchElementException e) {
            System.out.println(e.getMessage());
        }
        Assert.assertTrue(welcomeText != null);
        test.log(Status.PASS,"Verified Login Success............");

    }
    
    @AfterClass
    public void afterClass() throws InterruptedException {
        driver.quit();
//        刷新
        reports.flush();
    }
}

运行结果：在我指定的目录下生成了一个测试报告文件。

测试报告文件内容：

 错误总结：

我的ExtentReport  jar包最先是直接从网站下载然后build到我的java项目中，这就导致了我的testcase类中如果不调用该jar包中的remove方法运行时就会报错且无法成功生成测试报告文件，于是我更换了最新的ExtentReport  jar版本4.0.9，仍然无法解决。查阅了一大堆资料后仍为解决，忍无可忍只能通过maven直接在线加载ExtentReport   jar包并删除了testcase中的remove方法，最终运行成功，文件也成功生成到指定目录。（先把原先导入的包删除掉在maven新的jar包）

maven下载地址：

<dependency>

<groupId>com.aventstack</groupId>

<artifactId>extentreports</artifactId>

<version>3.0.6</version>

</dependency>

3、如何把普通项目转换为maven项目

在eclipse中找到需要转换的项目然后右击，按下图标识选择。

 然后点击下图的finish。

 成功后就可以看到项目中出现了一个pom.xml文件。

 打开这个文件，把上面下载的extentreports代码标签复制到xml文件中的如图所示位置，点击保存，jar包就自动下载到了项目中。

如果有不明白的小伙伴可以加群“555191854”问我，群里都是软件行业的小伙伴相互一起学习。

内容具有连惯性，未标注的地方可以看前面的博客，这是一整套关于ava+selenium自动化的内容，从java基础开始。

欢迎关注，转载请注明来源。