com.relevantcodes.extentreports

Class ExtentReports

java.lang.Object

com.relevantcodes.extentreports.LogSettings

com.relevantcodes.extentreports.ExtentReports

public class ExtentReports
extends LogSettings

Constructor Summary

Constructors

Constructor and Description
ExtentReports(java.lang.String filePath) Initializes Extent HTML report Default setting (true) is used for replaceExisting Default setting DisplayOrder.OLDEST_FIRST is used for DisplayOrder Default setting NetworkMode.ONLINE for NetworkMode is used
ExtentReports(java.lang.String filePath, java.lang.Boolean replaceExisting) Initializes Extent HTML report Default setting DisplayOrder.OLDEST_FIRST is used for DisplayOrder Default setting NetworkMode.ONLINE for NetworkMode is used
ExtentReports(java.lang.String filePath, java.lang.Boolean replaceExisting, DisplayOrder displayOrder) Initializes Extent HTML report Default setting NetworkMode.ONLINE for NetworkMode is used
ExtentReports(java.lang.String filePath, java.lang.Boolean replaceExisting, DisplayOrder displayOrder, NetworkMode networkMode) Initializes Extent HTML report
ExtentReports(java.lang.String filePath, java.lang.Boolean replaceExisting, NetworkMode networkMode) Initializes Extent HTML report Default setting DisplayOrder.OLDEST_FIRST is used for DisplayOrder
ExtentReports(java.lang.String filePath, NetworkMode networkMode) Initializes Extent HTML report Default setting (true) is used for replaceExisting Default setting DisplayOrder.OLDEST_FIRST is used for DisplayOrder

Method Summary

Modifier and Type	Method and Description
ExtentReports	addSystemInfo(java.util.Map<java.lang.String,java.lang.String> info) Add system information to the SystemInfo view
ExtentReports	addSystemInfo(java.lang.String param, java.lang.String value) Add system information to the SystemInfo view
void	close() Closes the underlying stream and clears all resources
HTMLReporter.Config	config() Deprecated.
void	endTest(ExtentTest extentTest) Ends the current test
void	flush() Appends the HTML file with all the ended tests.
void	loadConfig(java.lang.Class clazz, java.lang.String fileName) Allows performing configuration and customization to the HTML report from local resource
void	loadConfig(java.lang.Class clazz, java.lang.String basePackagePath, java.lang.String fileName) Allows performing configuration and customization to the HTML report from local resource.
void	loadConfig(java.io.File configFile) Allows performing configuration and customization to the HTML report from configuration external file
void	loadConfig(java.net.URL url) Allows performing configuration and customization to the HTML report from URL resource
void	setTestRunnerOutput(java.lang.String log) Adds logs from test framework tools such as TestNG
ExtentReports	startReporter(ReporterType reporterType, java.lang.String filePath) Starts a custom reporter based upon ReporterType.
ExtentTest	startTest(java.lang.String testName) Calling startTest() generates a toggle for the test in the HTML file and adds all log events under this level.
ExtentTest	startTest(java.lang.String testName, java.lang.String description) Calling startTest() generates a toggle for the test in the HTML file and adds all log events under this level.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtentReports

public ExtentReports(java.lang.String filePath,
                     java.lang.Boolean replaceExisting,
                     DisplayOrder displayOrder,
                     NetworkMode networkMode)

Initializes Extent HTML report

Parameters:

filePath - Path of the file, in .htm or .html format

replaceExisting - Setting to overwrite (TRUE) the existing file or append (FALSE) to it

• true - the file will be replaced with brand new markup, and all existing data will be lost. Use this option to create a brand new report
• false - existing data will remain, new tests will be appended to the existing report. If the the supplied path does not exist, a new file will be created.

displayOrder - Determines the order in which your tests will be displayed

• OLDEST_FIRST (default) - oldest test at the top, newest at the end
• NEWEST_FIRST - newest test at the top, oldest at the end

networkMode -

• ONLINE - creates a single report file with all artifacts
• OFFLINE - all report artifacts will be stored locally in %reportFolder%/extentreports with the following structure:
  - extentreports/css
  - extentreports/js

ExtentReports

public ExtentReports(java.lang.String filePath,
                     java.lang.Boolean replaceExisting,
                     DisplayOrder displayOrder)

Initializes Extent HTML report

• Default setting NetworkMode.ONLINE for NetworkMode is used

Parameters:

filePath - Path of the file, in .htm or .html format

replaceExisting - Setting to overwrite (TRUE) the existing file or append (FALSE) to it

• true - the file will be replaced with brand new markup, and all existing data will be lost. Use this option to create a brand new report
• false - existing data will remain, new tests will be appended to the existing report. If the the supplied path does not exist, a new file will be created.

displayOrder - Determines the order in which your tests will be displayed

• OLDEST_FIRST (default) - oldest test at the top, newest at the end
• NEWEST_FIRST - newest test at the top, oldest at the end

ExtentReports

public ExtentReports(java.lang.String filePath,
                     java.lang.Boolean replaceExisting,
                     NetworkMode networkMode)

Initializes Extent HTML report

• Default setting DisplayOrder.OLDEST_FIRST is used for DisplayOrder

Parameters:

filePath - Path of the file, in .htm or .html format

replaceExisting - Setting to overwrite (TRUE) the existing file or append (FALSE) to it

• true - the file will be replaced with brand new markup, and all existing data will be lost. Use this option to create a brand new report
• false - existing data will remain, new tests will be appended to the existing report. If the the supplied path does not exist, a new file will be created.

networkMode -

• ONLINE - creates a single report file with all artifacts
• OFFLINE - all report artifacts will be stored locally in %reportFolder%/extentreports with the following structure:
  - extentreports/css
  - extentreports/js

ExtentReports

public ExtentReports(java.lang.String filePath,
                     NetworkMode networkMode)

Initializes Extent HTML report

• Default setting (true) is used for replaceExisting
• Default setting DisplayOrder.OLDEST_FIRST is used for DisplayOrder

Parameters:

filePath - Path of the file, in .htm or .html format

networkMode -

• ONLINE - creates a single report file with all artifacts
• OFFLINE - all report artifacts will be stored locally in %reportFolder%/extentreports with the following structure:
  - extentreports/css
  - extentreports/js

ExtentReports

public ExtentReports(java.lang.String filePath,
                     java.lang.Boolean replaceExisting)

Initializes Extent HTML report

• Default setting DisplayOrder.OLDEST_FIRST is used for DisplayOrder
• Default setting NetworkMode.ONLINE for NetworkMode is used

Parameters:

filePath - Path of the file, in .htm or .html format

replaceExisting - Setting to overwrite (TRUE) the existing file or append (FALSE) to it

• true - the file will be replaced with brand new markup, and all existing data will be lost. Use this option to create a brand new report
• false - existing data will remain, new tests will be appended to the existing report. If the the supplied path does not exist, a new file will be created.

ExtentReports

public ExtentReports(java.lang.String filePath)

Initializes Extent HTML report

• Default setting (true) is used for replaceExisting
• Default setting DisplayOrder.OLDEST_FIRST is used for DisplayOrder
• Default setting NetworkMode.ONLINE for NetworkMode is used

Parameters:

filePath - Path of the file, in .htm or .html format

Method Detail

loadConfig

public void loadConfig(java.io.File configFile)

Allows performing configuration and customization to the HTML report from configuration external file

Parameters:

configFile - Config file (extent-config.xml)

loadConfig

public void loadConfig(java.net.URL url)

Allows performing configuration and customization to the HTML report from URL resource

Parameters:

url - URL pointer to the resource file

loadConfig

public void loadConfig(java.lang.Class clazz,
                       java.lang.String fileName)

Allows performing configuration and customization to the HTML report from local resource

Parameters:

clazz - The class relative to which the configuration file will be loaded

fileName - Name of the file from the clazz package

loadConfig

public void loadConfig(java.lang.Class clazz,
                       java.lang.String basePackagePath,
                       java.lang.String fileName)

Allows performing configuration and customization to the HTML report from local resource.

Example: Sonsider the following clazz, basePackagePath and fileName:

• clazz : "com/relevantcodes/extentreports/ExtentReports.class"
• basePackagePath : "resources"
• fileName : "extent-config.xml"

The above inputs will build the final path as: "com/relevantcodes/extentreports/resources/extent-config.xml"

Parameters:

clazz - The class relative to which the configuration file will be loaded

basePackagePath - The package that contains the configuration file. The basePackagePath is relative to the clazz

fileName - Name of the file from the clazz package

startReporter

public ExtentReports startReporter(ReporterType reporterType,
                                   java.lang.String filePath)

Starts a custom reporter based upon ReporterType. The file extension determines if the reporter-type will be started.

For ReporterType the extension must be .db

Parameters:

reporterType - ReporterType Type of the reporter to be initialized

filePath - Path of the report source, with the correct extension for the reporter

Returns:

An ExtentReports object

startTest

public ExtentTest startTest(java.lang.String testName)

Calling startTest() generates a toggle for the test in the HTML file and adds all log events under this level. This is a required step and without calling this method the toggle will not be created for the test and log will not be added.

Parameters:

testName - Name of the test

Returns:

An ExtentTest object

startTest

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

Calling startTest() generates a toggle for the test in the HTML file and adds all log events under this level. This is a required step and without calling this method the toggle will not be created for the test and log will not be added.

Parameters:

testName - Name of the test

description - A short description of the test

Returns:

An ExtentTest object

endTest

public void endTest(ExtentTest extentTest)

Ends the current test

If ReporterType.DBis used, a row in the TEST table is created

Parameters:

extentTest - An ExtentTest object

addSystemInfo

public ExtentReports addSystemInfo(java.util.Map<java.lang.String,java.lang.String> info)

Add system information to the SystemInfo view

Parameters:

info - SystemInfo values as Key-Value pairs

Returns:

An ExtentReports object

addSystemInfo

public ExtentReports addSystemInfo(java.lang.String param,
                                   java.lang.String value)

Add system information to the SystemInfo view

Parameters:

param - Name of system parameter

value - Value of system parameter

Returns:

An ExtentReports object

setTestRunnerOutput

public void setTestRunnerOutput(java.lang.String log)

Adds logs from test framework tools such as TestNG

Parameters:

log - Log string from the TestRunner

flush

public void flush()

Appends the HTML file with all the ended tests. There must be at least 1 ended test for anything to be appended to the report.

Note: If flush() is called before any of the ended tests, no information will be appended.

Note: If flush() while the test is running (not yet ended), it will not be appended to the report.

close

public void close()

Closes the underlying stream and clears all resources

If any of your test ended abruptly causing any side-affects (not all logs sent to ExtentReports, information missing), this method will ensure that the test is still appended to the report with a warning message.

config

@Deprecated
public HTMLReporter.Config config()

Deprecated.

This method is deprecated and replace with an external configuration file. For more information, visit this link: extentreports.relevantcodes.com/java/version2/docs.html#configuration

Returns:

HTMLReporter.Config object