com.aventstack.extentreports

Class ExtentReports

java.lang.Object

com.aventstack.extentreports.ExtentReports

All Implemented Interfaces:

IReport

public class ExtentReports
extends java.lang.Object

The ExtentReports report client for starting reporters and building reports. For most applications, you should have one ExtentReports instance for the entire JVM.

ExtentReports itself does not build any reports, but allows reporters to access information, which in turn build the said reports. An example of building an HTML report and adding information to ExtentX:

 ExtentHtmlReporter html = new ExtentHtmlReporter("Extent.html");
 ExtentXReporter extentx = new ExtentXReporter("localhost");
 
 ExtentReports extent = new ExtentReports();
 extent.attachReporter(html, extentx);
 
 extent.createTest("TestName").pass("Test Passed");
 
 extent.flush();
 

A few notes:

• It is mandatory to call the flush method to ensure information is written to the started reporters.
• You can create standard and BDD-style tests using the createTest method

See Also:

ExtentTest, GherkinKeyword, IGherkinFormatterModel, Status

Field Summary

Fields

Modifier and Type	Field and Description
protected AnalysisStrategy	strategy
protected boolean	usesManualConfiguration

Constructor Summary

Constructors

Constructor and Description
ExtentReports()

Method Summary

Modifier and Type	Method and Description
protected void	attach(ExtentReporter reporter)
void	attachReporter(ExtentReporter... reporter) Attach a ExtentReporter reporter, allowing it to access all started tests, nodes and logs
ReportConfigurator	config() Provides common report configurations
ExtentTest	createTest(java.lang.Class<? extends IGherkinFormatterModel> type, java.lang.String testName) Creates a BDD-style test representing one of the IGherkinFormatterModel classes such as: Feature Background Scenario Given When Then And
ExtentTest	createTest(java.lang.Class<? extends IGherkinFormatterModel> type, java.lang.String testName, java.lang.String description) Creates a BDD-style test with description representing one of the IGherkinFormatterModel classes such as: Feature Background Scenario Given When Then And
ExtentTest	createTest(GherkinKeyword gherkinKeyword, java.lang.String testName) Creates a BDD-style test using name of the Gherkin model such as: Feature Background Scenario Given When Then And
ExtentTest	createTest(GherkinKeyword gherkinKeyword, java.lang.String testName, java.lang.String description) Creates a BDD-style test with description using name of the Gherkin model such as: Feature Background Scenario Given When Then And
ExtentTest	createTest(java.lang.String testName) Creates a test
ExtentTest	createTest(java.lang.String testName, java.lang.String description) Creates a test with description
protected void	createTest(Test test)
protected void	detach(ExtentReporter reporter)
protected void	end()
void	flush() Writes test information from the started reporters to their output view ExtentHtmlReporter - creates or appends to an HTML file ExtentXReporter - updates database ExtentEmailReporter - creates or appends to an HTML file ExtentLogger - no action taken
protected TestAttributeTestContextProvider<Author>	getAuthorContextInfo()
void	removeTest(ExtentTest test) Removes a test
protected void	removeTest(Test test)
void	setAnalysisStrategy(AnalysisStrategy strategy) Type of AnalysisStrategy for the reporter.
void	setReportUsesManualConfiguration(boolean b) Use this setting when building post-execution reports, such as from TestNG IReporter
void	setSystemInfo(java.lang.String k, java.lang.String v) Adds any applicable system information to all started reporters
protected void	setSystemInfo(SystemAttribute sa)
protected void	setTestRunnerLogs(java.lang.String log)
void	setTestRunnerOutput(java.util.List<java.lang.String> log) Adds logs from test framework tools to the test-runner logs view (if available in the reporter)
void	setTestRunnerOutput(java.lang.String log) Adds logs from test framework tools to the test-runner logs view (if available in the reporter)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

usesManualConfiguration

protected boolean usesManualConfiguration

strategy

protected AnalysisStrategy strategy

Constructor Detail

ExtentReports

public ExtentReports()

Method Detail

attachReporter

public void attachReporter(ExtentReporter... reporter)

Attach a ExtentReporter reporter, allowing it to access all started tests, nodes and logs

Available reporter types are:

• com.aventstack.extentreports.gherkin.model.ExtentHtmlReporter
• com.aventstack.extentreports.gherkin.model.ExtentEmailReporter
• com.aventstack.extentreports.gherkin.model.ExtentXReporter
• com.aventstack.extentreports.gherkin.model.ExtentLogger

Parameters:

reporter - ExtentReporter reporter

createTest

public ExtentTest createTest(java.lang.Class<? extends IGherkinFormatterModel> type,
                             java.lang.String testName,
                             java.lang.String description)

Creates a BDD-style test with description representing one of the IGherkinFormatterModel classes such as:

• Feature
• Background
• Scenario
• Given
• When
• Then
• And

Example:

 extent.createTest(Feature.class, "bddTest", "description");
 

Note: BDD styling is not available on ExtentX server. Your tests will show as regular nodes 2 levels deep.

Parameters:

type - A IGherkinFormatterModel type

testName - Name of test

description - A short description of the test

Returns:

ExtentTest object

createTest

public ExtentTest createTest(java.lang.Class<? extends IGherkinFormatterModel> type,
                             java.lang.String testName)

Creates a BDD-style test representing one of the IGherkinFormatterModel classes such as:

• Feature
• Background
• Scenario
• Given
• When
• Then
• And

Example:

 extent.createTest(Feature.class, "bddTest");
 

Note: BDD styling is not available on ExtentX server. Your tests will show as regular nodes 2 levels deep.

Parameters:

type - A IGherkinFormatterModel type

testName - Name of test

Returns:

ExtentTest object

createTest

public ExtentTest createTest(GherkinKeyword gherkinKeyword,
                             java.lang.String testName,
                             java.lang.String description)

Creates a BDD-style test with description using name of the Gherkin model such as:

• Feature
• Background
• Scenario
• Given
• When
• Then
• And

Example:

 extent.createTest(new GherkinKeyword("Feature"), "bddTest", "description");
 

Note: BDD styling is not available on ExtentX server. Your tests will show as regular nodes 2 levels deep.

Parameters:

gherkinKeyword - Name of the GherkinKeyword

testName - Name of test

description - A short description of the test

Returns:

ExtentTest object

createTest

public ExtentTest createTest(GherkinKeyword gherkinKeyword,
                             java.lang.String testName)

Creates a BDD-style test using name of the Gherkin model such as:

• Feature
• Background
• Scenario
• Given
• When
• Then
• And

Example:

 extent.createTest(new GherkinKeyword("Feature"), "bddTest", "description");
 

Note: BDD styling is not available on ExtentX server. Your tests will show as regular nodes 2 levels deep.

Parameters:

gherkinKeyword - Name of the GherkinKeyword

testName - Name of test

Returns:

ExtentTest object

createTest

public ExtentTest createTest(java.lang.String testName,
                             java.lang.String description)

Creates a test with description

Parameters:

testName - Name of test

description - A short test description

Returns:

ExtentTest object

createTest

public ExtentTest createTest(java.lang.String testName)

Creates a test

Parameters:

testName - Name of test

Returns:

ExtentTest object

removeTest

public void removeTest(ExtentTest test)

Removes a test

Parameters:

test - ExtentTest object

flush

public void flush()

Writes test information from the started reporters to their output view

• ExtentHtmlReporter - creates or appends to an HTML file
• ExtentXReporter - updates database
• ExtentEmailReporter - creates or appends to an HTML file
• ExtentLogger - no action taken

setSystemInfo

public void setSystemInfo(java.lang.String k,
                          java.lang.String v)

Adds any applicable system information to all started reporters

Example:

 extent.setSystemInfo("HostName", "AventStack-PC");
 

Parameters:

k - Name of system variable

v - Value of system variable

setTestRunnerOutput

public void setTestRunnerOutput(java.util.List<java.lang.String> log)

Adds logs from test framework tools to the test-runner logs view (if available in the reporter)

Parameters:

log - Log string from the test runner frameworks such as TestNG or JUnit

setTestRunnerOutput

public void setTestRunnerOutput(java.lang.String log)

Adds logs from test framework tools to the test-runner logs view (if available in the reporter)

Parameters:

log - Log string from the test runner frameworks such as TestNG or JUnit

setReportUsesManualConfiguration

public void setReportUsesManualConfiguration(boolean b)

Use this setting when building post-execution reports, such as from TestNG IReporter

Parameters:

b - Set to true if building reports at the end of execution with manual configuration

setAnalysisStrategy

public void setAnalysisStrategy(AnalysisStrategy strategy)

Type of AnalysisStrategy for the reporter. Not all reporters support this setting.

There are 2 types of strategies available:

• CLASS: Shows analysis in 3 different charts: Class, Test and Step (log)
• TEST: Shows analysis in 2 different charts: Test and Step (log)s

Parameters:

strategy - AnalysisStrategy determines the type of analysis (dashboard) created for the reporter. Not all reporters will support this setting.

config

public ReportConfigurator config()

Provides common report configurations

Returns:

an instance of ReportConfigurator

attach

protected void attach(ExtentReporter reporter)

detach

protected void detach(ExtentReporter reporter)

createTest

protected void createTest(Test test)

removeTest

protected void removeTest(Test test)

getAuthorContextInfo

protected TestAttributeTestContextProvider<Author> getAuthorContextInfo()

end

protected void end()

setSystemInfo

protected void setSystemInfo(SystemAttribute sa)

setTestRunnerLogs

protected void setTestRunnerLogs(java.lang.String log)