Skip to content
Testomatio

Html

Testomat.io HTML Pipe

The Testomat.io HTML Pipe is a feature that allows you to generate and save HTML reports based on your test results. This functionality is part of the Testomat.io testing ecosystem.

Prerequisites

🔌 TESTOMATIO users now have the option to generate an HTML report based on their test execution results. If a user hasn’t SET TESTOMATIO environment, the report will still be generated

TESTOMATIO_HTML_REPORT_SAVE=1 <actual run command>

Enabling HTML Reports

To enable HTML reports, set the TESTOMATIO_HTML_REPORT_SAVE environment variable to 1. Additionally, you can customize the HTML report folder and filename using the following variables:

  • TESTOMATIO_HTML_REPORT_SAVE=1
  • TESTOMATIO_HTML_REPORT_FOLDER: Specify the folder for HTML reports
  • TESTOMATIO_HTML_FILENAME: Set the desired filename for the HTML report

!!!Please note that the name must include the extension “.html”. If the extension is missing, the report will be saved with the default name = testomatio-report.html

Usage

The HTML Pipe operates as part of the test execution process. When running your tests with the specified environment variables, the HTML Pipe will generate reports based on the test results.

Report Generation

Once the test run is complete, the HTML Pipe compiles the test results and generates an HTML report. The generated report is saved to the specified HTML output path.

The HTML report includes essential information, such as run ID, status, parallel execution indication, run URL, execution time, execution date, and details of individual tests.

Example Command

📊 Generate a report without triggering the TESTOMATIO pipe (no data sent to the client)

Execute the following command to generate a report without sending data to TESTOMATIO:

TESTOMATIO_HTML_REPORT_SAVE=1 npx codeceptjs run

📝 Generate a report based on the default folder/html-file name: This command triggers the test execution process and enables the HTML Pipe to generate reports based on the test results:

  • Output folder: html-report/
  • Output file: testomatio-report.html

Execute the following command to generate a report with default settings:

TESTOMATIO_HTML_REPORT_SAVE=1 TESTOMATIO={API_KEY} npx codeceptjs run

📂 Generate a report based on a custom HTML folder/html-file name. !!!You can SET only one of the following parameters if needed: folder or file name

Execute the following command to generate a report with both folder & file names:

TESTOMATIO_HTML_REPORT_SAVE=1 TESTOMATIO_HTML_REPORT_FOLDER=user-html-reporter TESTOMATIO_HTML_FILENAME=custom.html TESTOMATIO={API_KEY} npx codeceptjs run

🖥️ An example of a report can be seen in the screenshot below:

HTML example