To learn more about using JavaScript in LeanFT, see Setting up and working with the JavaScript SDK.
For JavaScript code samples, see Code Samples - JavaScript.

Reporter

Reporter

Reporter namespace

Methods

addRunInformation(fieldName, fieldValue) → {void}

Adds a custom entry to the top section of the LeanFT report.
Parameters:
Name Type Description
fieldName string The name of the entry.
fieldValue string The entry value.
Returns:
Type
void

endReportingContext() → {Promise.<void>}

Ends the section in the LeanFT report.
Returns:
Type
Promise.<void>

endSpec(specDescriptionopt) → {void}

Ends the current spec level and optionally sets the status for the spec.
Parameters:
Name Type Attributes Description
specDescription Reporter.Status <optional>
The status for the current spec. Default = Passed.
Returns:
Type
void

generateReport() → {null|string}

Generates the LeanFT report.
Returns:
the path to the LeanFT report.
Type
null | string

getStatus() → {Reporter.Status}

Returns the runtime status of the LeanFT report.
Returns:
the runtime status of the LeanFT report.
Type
Reporter.Status

reportErrorEvent(stepName, description, exception) → {void}

Adds a custom step to the LeanFT report including exception details.
Parameters:
Name Type Description
stepName string The name of the reported step. This name is the label of the step node in the report.
description string The description of the reported step. The description is displayed in the Details pane of the report.
exception Error The exception that occurred.
Returns:
Type
void

reportErrorEventWithImage(stepName, description, exception, image) → {void}

Adds a custom step to the LeanFT report including exception details and the Base64 image.
Parameters:
Name Type Description
stepName string The name of the reported step. This name is the label of the step node in the report.
description string The description of the reported step. The description is displayed in the Details pane of the report.
exception Error The exception that occurred.
image string The Base64 image to use for the step.
Returns:
Type
void

reportEvent(stepName, description, statusopt) → {void}

Adds a custom step to the LeanFT report with default status "Passed".
Parameters:
Name Type Attributes Description
stepName string The name of the reported step. This name is the label of the step node in the report.
description string The description of the reported step. The description is displayed in the Details pane of the report.
status Reporter.Status <optional>
The status for the step.
Returns:
Type
void

reportEventWithImage(stepName, description, statusopt, image) → {void}

Adds a custom step to the LeanFT report with default status "Passed" and an image.
Parameters:
Name Type Attributes Description
stepName string The name of the reported step. This name is the label of the step node in the report.
description string The description of the reported step. The description is displayed in the Details pane of the report.
status Reporter.Status <optional>
The status for the step.
image string The Base64 image to use for the step.
Returns:
Type
void

reportVerification(status, verificationData) → {void}

Adds a custom verification step to the LeanFT report.
Parameters:
Name Type Description
status string The verification result status.
verificationData Reporter.VerificationData The report verification data.
Returns:
Type
void

setSnapshotCaptureLevel(snapshotCaptureLevel) → {void}

Sets the snapshot capture level used to generate the LeanFT report.
Parameters:
Name Type Description
snapshotCaptureLevel number The CaptureLevel to use.
Returns:
Type
void

startReportingContext(contextName, contextDescriptionopt) → {Promise.<void>}

Starts a named section in the LeanFT report.
Parameters:
Name Type Attributes Description
contextName string The section name.
contextDescription string <optional>
The section description. Default=blank.
Returns:
Type
Promise.<void>

startSpec(specName, specDescription) → {void}

Starts a new spec level for the LeanFT report.
Parameters:
Name Type Description
specName string The name of the spec, that is, the label of the spec node in the report.
specDescription string The spec description.
Returns:
Type
void

Type Definitions

CaptureLevel

The possible levels for capturing snapshots for the report.
Type:
  • Object
Properties:
Name Type Description
All number Snapshots are captured for all test object operations.
OnError number TSnapshots are captured only for test object operations with errors.
Off number Snapshots are not captured.

ReportLevel

The possible levels for reporting events to the LeanFT Report.
Type:
  • Object
Properties:
Name Type Description
All string Report events on all levels.
Warning string Report only events with the status Warning or Error.
Error string Report only events with the status Error.
Off string Disable all report levels. A LeanFT report is not created.

Status

The possible statuses of an event reported to the LeanFT report.
Type:
  • Object
Properties:
Name Type Description
Passed string The event related to the node and all of its sub-nodes succeeded.
Failed string The event related to the node or to one of its sub-nodes failed.
Warning string The event related to the node or to one of its sub-nodes resulted in a warning.

VerificationData

Represents the data used to report a custom verification step.
Type:
  • Object
Properties:
Name Type Description
data object A property bag containing possible data for the VerificationData object
Properties
Name Type Description
name string The name of the verification presented in the report file.
description string The verification description presented in the report file.
parameters string Array of property bags with name/value pairs, representing the parameters data used in the context of the custom verification step, presented in the report file.
image string The Base64 verification image presented in the report file.