@testomatio/reporter 1.2.0-beta-4 → 1.2.0

package/lib/pipe/html.js

@@ -10,246 +10,248 @@ const { fileSystem, isSameTest, ansiRegExp } = require('../utils/utils');
 const { HTML_REPORT } = require('../constants');
 
 class HtmlPipe {
-    constructor(params, store = {}) {
-        this.store = store || {};
-        this.title = params.title || process.env.TESTOMATIO_TITLE;
-        this.apiKey = params.apiKey || process.env.TESTOMATIO;
-        this.isHtml = process.env.TESTOMATIO_HTML_REPORT_SAVE;
-
-        debug('HTML Pipe: ', this.apiKey ? 'API KEY' : '*no api key provided*');
-
-        this.isEnabled = false;
-        this.htmlOutputPath = "";
-        this.fullHtmlOutputPath = "";
-        this.filenameMsg = "";
-        this.tests = [];
-
-        if (this.isHtml) {
-            this.isEnabled = true;
-            this.htmlReportDir = process.env.TESTOMATIO_HTML_REPORT_FOLDER || HTML_REPORT.FOLDER;
-
-            if (process.env.TESTOMATIO_HTML_FILENAME && process.env.TESTOMATIO_HTML_FILENAME.endsWith(".html")) {
-                this.htmlReportName = process.env.TESTOMATIO_HTML_FILENAME
-            }
-
-            if (process.env.TESTOMATIO_HTML_FILENAME && !process.env.TESTOMATIO_HTML_FILENAME.endsWith(".html")) {
-                this.htmlReportName = HTML_REPORT.REPORT_DEFAULT_NAME;
-                this.filenameMsg = "HTML filename must include the extension \".html\"." +
-                    ` The default report name "${this.htmlReportDir}/${HTML_REPORT.REPORT_DEFAULT_NAME}" is used!`;
-            }
-
-            if (!process.env.TESTOMATIO_HTML_FILENAME) {
-                this.htmlReportName = HTML_REPORT.REPORT_DEFAULT_NAME;
-            }
-
-            this.templateFolderPath = path.resolve(__dirname, '..', 'template');
-            this.templateHtmlPath = path.resolve(this.templateFolderPath, HTML_REPORT.TEMPLATE_NAME);
-            this.htmlOutputPath = path.join(this.htmlReportDir, this.htmlReportName);
-            // create a new folder for the HTML reports
-            fileSystem.createDir(this.htmlReportDir);
-
-            debug(
-                chalk.yellow('HTML Pipe:'),
-                `Save HTML report: ${this.isEnabled}`,
-                `HTML report folder: ${this.htmlReportDir}, report name: ${this.htmlReportName}`
-            );
-        }
+  constructor(params, store = {}) {
+    this.store = store || {};
+    this.title = params.title || process.env.TESTOMATIO_TITLE;
+    this.apiKey = params.apiKey || process.env.TESTOMATIO;
+    this.isHtml = process.env.TESTOMATIO_HTML_REPORT_SAVE;
+
+    debug('HTML Pipe: ', this.apiKey ? 'API KEY' : '*no api key provided*');
+
+    this.isEnabled = false;
+    this.htmlOutputPath = '';
+    this.fullHtmlOutputPath = '';
+    this.filenameMsg = '';
+    this.tests = [];
+
+    if (this.isHtml) {
+      this.isEnabled = true;
+      this.htmlReportDir = process.env.TESTOMATIO_HTML_REPORT_FOLDER || HTML_REPORT.FOLDER;
+
+      if (process.env.TESTOMATIO_HTML_FILENAME && process.env.TESTOMATIO_HTML_FILENAME.endsWith('.html')) {
+        this.htmlReportName = process.env.TESTOMATIO_HTML_FILENAME;
+      }
+
+      if (process.env.TESTOMATIO_HTML_FILENAME && !process.env.TESTOMATIO_HTML_FILENAME.endsWith('.html')) {
+        this.htmlReportName = HTML_REPORT.REPORT_DEFAULT_NAME;
+        this.filenameMsg =
+          'HTML filename must include the extension ".html".' +
+          ` The default report name "${this.htmlReportDir}/${HTML_REPORT.REPORT_DEFAULT_NAME}" is used!`;
+      }
+
+      if (!process.env.TESTOMATIO_HTML_FILENAME) {
+        this.htmlReportName = HTML_REPORT.REPORT_DEFAULT_NAME;
+      }
+
+      this.templateFolderPath = path.resolve(__dirname, '..', 'template');
+      this.templateHtmlPath = path.resolve(this.templateFolderPath, HTML_REPORT.TEMPLATE_NAME);
+      this.htmlOutputPath = path.join(this.htmlReportDir, this.htmlReportName);
+      // create a new folder for the HTML reports
+      fileSystem.createDir(this.htmlReportDir);
+
+      debug(
+        chalk.yellow('HTML Pipe:'),
+        `Save HTML report: ${this.isEnabled}`,
+        `HTML report folder: ${this.htmlReportDir}, report name: ${this.htmlReportName}`,
+      );
     }
-
-    async createRun() {
-        // empty
+  }
+
+  async createRun() {
+    // empty
+  }
+
+  updateRun() {
+    // empty
+  }
+
+  /**
+   * Add test data to the result array for saving. As a result of this function, we get a result object to save.
+   * @param {import('../../types').RunData} test - object which includes each test entry.
+   */
+  addTest(test) {
+    if (!this.isEnabled) return;
+
+    if (!test.status) return;
+
+    const index = this.tests.findIndex(t => isSameTest(t, test));
+    // update if they were already added
+    if (index >= 0) {
+      this.tests[index] = merge(this.tests[index], test);
+      return;
     }
 
-    updateRun() {
-        // empty
+    this.tests.push(test);
+  }
+
+  async finishRun(runParams) {
+    if (!this.isEnabled) return;
+
+    if (this.isHtml) {
+      // GENERATE HTML reports based on the results data
+      this.buildReport({
+        runParams,
+        // TODO: this.tests=[] in case of Mocha
+        tests: this.tests,
+        outputPath: this.htmlOutputPath,
+        templatePath: this.templateHtmlPath,
+        warningMsg: this.filenameMsg,
+      });
     }
-
-    /**
-     * Add test data to the result array for saving. As a result of this function, we get a result object to save.
-     * @param {Object} test - object which includes each test entry.
-     */
-    addTest(test) {
-        if (!this.isEnabled) return;
-
-        if (!test.steps || !test.status) return;
-
-        const index = this.tests.findIndex(t => isSameTest(t, test));
-        // update if they were already added
-        if (index >= 0) {
-            this.tests[index] = merge(this.tests[index], test);
-            return;
-        }
-
-        this.tests.push(test);
-    }
-
-    async finishRun(runParams) {
-        if (!this.isEnabled) return;
-
-        if (this.isHtml) {
-            // GENERATE HTML reports based on the results data
-            this.buildReport({
-                runParams,
-                tests: this.tests, 
-                outputPath: this.htmlOutputPath, 
-                templatePath: this.templateHtmlPath, 
-                warningMsg: this.filenameMsg
-            });
-        }
+  }
+  /**
+   * Generates an HTML report based on provided test data and a template.
+   * @param {object} opts - Test options used to generate the HTML report:
+   * runParams, tests, outputPath, templatePath
+   * @returns {void} - This function does not return anything.
+   */
+
+  buildReport(opts) {
+    const { runParams, tests, outputPath, templatePath, warningMsg: msg } = opts;
+
+    debug('HTML tests data:', tests);
+
+    if (!outputPath) {
+      console.log(chalk.yellow(`🚨 HTML export path is not set, ignoring...`));
+      return;
     }
-    /**
-     * Generates an HTML report based on provided test data and a template.
-     * @param {object} opts - Test options used to generate the HTML report: 
-     * runParams, tests, outputPath, templatePath
-     * @returns {void} - This function does not return anything.
-     */
-
-    buildReport(opts) {
-        const { runParams, tests, outputPath, templatePath, warningMsg: msg } = opts;
-        
-        debug('HTML tests data:', tests);
-
-        if (!outputPath) {
-            console.log(chalk.yellow(`🚨 HTML export path is not set, ignoring...`));
-            return;
-        }
-
-        console.log(chalk.yellow(`⏳ The test results will be added to the HTML report. It will take some time...`));
 
-        if (msg) {
-            console.log(chalk.blue(msg));
-        }
+    console.log(chalk.yellow(`⏳ The test results will be added to the HTML report. It will take some time...`));
 
-        tests.forEach(test => {
-
-            if (!test.message || test.message.trim() === "") {
-                test.message = "This test has no 'message' code";
-            }
+    if (msg) {
+      console.log(chalk.blue(msg));
+    }
 
-            if (!test.suite_title || test.suite_title.trim() === "") {
-                test.suite_title = "Unknown suite";
-            }
+    tests.forEach(test => {
+      if (!test.message || test.message.trim() === '') {
+        test.message = "This test has no 'message' code";
+      }
 
-            if (!test.title || test.title.trim() === "") {
-                test.title = "Unknown test title";
-            }
+      if (!test.suite_title || test.suite_title.trim() === '') {
+        test.suite_title = 'Unknown suite';
+      }
 
-            if (!test.files || test.files.length === 0) {
-                test.files = "This test has no files";
-            }
+      if (!test.title || test.title.trim() === '') {
+        test.title = 'Unknown test title';
+      }
 
-            if (test.steps) {
-                if (!test.steps || test.steps.trim() === "") {
-                    test.steps = "This test has no 'steps' code";
-                }
-                else {
-                    test.steps = removeAnsiColorCodes(test.steps);
-                }
-            }
-            
-            // TODO: u can added an additional test values to this checks in the future
-        });
+      if (!test.files || test.files.length === 0) {
+        test.files = 'This test has no files';
+      }
 
-        const data = {
-            runId: this.store.runId || "",
-            status: runParams.status || "No status info",
-            parallel: runParams.isParallel || "No parallel info",
-            runUrl: this.store.runUrl || "",
-            executionTime: testExecutionSumTime(tests),
-            executionDate: getCurrentDateTimeFormatted(),
-            tests
-        };
-        // generate output HTML based on the template
-        const html = this.#generateHTMLReport(data, templatePath);
-
-        if (!html) return;
-
-        fs.writeFileSync(outputPath, html, 'utf-8');
-        // Check if the file exists
-        if (fs.existsSync(outputPath)) {
-            // Get the absolute path of the file
-            const absolutePath = path.resolve(outputPath);
-            // Convert the file path to a file URL
-            const fileUrlPath = fileUrl(absolutePath, {resolve: true});
-
-            debug('HTML tests data:', fileUrlPath);
-
-            console.log(chalk.green(`📊 The HTML report was successfully generated. Full filepath: ${fileUrlPath}`));
+      if (test.steps) {
+        if (!test.steps || test.steps.trim() === '') {
+          test.steps = "This test has no 'steps' code";
         } else {
-            console.log(chalk.red(`🚨 Failed to generate the HTML report.`));
+          test.steps = removeAnsiColorCodes(test.steps);
         }
+      }
+
+      // TODO: u can added an additional test values to this checks in the future
+    });
+
+    const data = {
+      runId: this.store.runId || '',
+      status: runParams.status || 'No status info',
+      parallel: runParams.isParallel || 'No parallel info',
+      runUrl: this.store.runUrl || '',
+      executionTime: testExecutionSumTime(tests),
+      executionDate: getCurrentDateTimeFormatted(),
+      tests,
+    };
+    // generate output HTML based on the template
+    const html = this.#generateHTMLReport(data, templatePath);
+
+    if (!html) return;
+
+    fs.writeFileSync(outputPath, html, 'utf-8');
+    // Check if the file exists
+    if (fs.existsSync(outputPath)) {
+      // Get the absolute path of the file
+      const absolutePath = path.resolve(outputPath);
+      // Convert the file path to a file URL
+      const fileUrlPath = fileUrl(absolutePath, { resolve: true });
+
+      debug('HTML tests data:', fileUrlPath);
+
+      console.log(chalk.green(`📊 The HTML report was successfully generated. Full filepath: ${fileUrlPath}`));
+    } else {
+      console.log(chalk.red(`🚨 Failed to generate the HTML report.`));
+    }
+  }
+
+  /**
+   * Generates an HTML report based on provided test data and a template path.
+   * @param {any} data - Test data used to generate the HTML report.
+   * @param {string} [templatePath=""] - The path to the HTML template used for generating the report.
+   * @returns {string | void} - The generated HTML report as a string or void if templatePath is not provided.
+   */
+  #generateHTMLReport(data, templatePath = '') {
+    if (!templatePath) {
+      console.log(chalk.red(`🚨 HTML template not found. Report generation is impossible!`));
+      return;
     }
 
-    /**
-     * Generates an HTML report based on provided test data and a template path.
-     * @param {any} data - Test data used to generate the HTML report.
-     * @param {string} [templatePath=""] - The path to the HTML template used for generating the report.
-     * @returns {string | void} - The generated HTML report as a string or void if templatePath is not provided.
-     */
-    #generateHTMLReport(data, templatePath = "") {
-        if (!templatePath) {
-            console.log(chalk.red(`🚨 HTML template not found. Report generation is impossible!`))
-            return;
-        }
-
-        const templateSource = fs.readFileSync(templatePath, 'utf8');
-        this.#loadReportHelpers();
-        try {
-            const template = handlebars.compile(templateSource);
+    const templateSource = fs.readFileSync(templatePath, 'utf8');
+    this.#loadReportHelpers();
+    try {
+      const template = handlebars.compile(templateSource);
 
-            return template(data);
-        }
-        catch (e) {
-            console.log('Unknown HTML report generation error: ', e);
-        }
+      return template(data);
+    } catch (e) {
+      console.log('Unknown HTML report generation error: ', e);
     }
-
-    #loadReportHelpers() {
-        handlebars.registerHelper('getTestsByStatus', (tests, status) => 
-            tests.filter(test => test.status.toLowerCase() === status.toLowerCase()).length
-        );
-
-        handlebars.registerHelper('json', (tests) => {
-            function replaceScriptTagsInArray(array) {
-                return array.map(obj => {
-                    const keysToCheck = ["steps", "stack", "title", "suite_title", "message", "code"];
-                    const newObj = {};
-            
-                    for (const key in obj) {
-                        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-                            if (key === "example") {
-                                newObj[key] = {};
-                                for (const subKey in obj[key]) {
-                                    if (Object.prototype.hasOwnProperty.call(obj[key], subKey)) {
-                                        newObj[key][subKey] = typeof obj[key][subKey] === "string"
-                                            ? obj[key][subKey]
-                                                .replace(/<script>/g, "<$cript>")
-                                                .replace(/<\/script>/g, "</$cript>")
-                                            : obj[key][subKey];
-                                    }
-                                }
-                            } else if (keysToCheck.includes(key)) {
-                                newObj[key] = typeof obj[key] === "string"
-                                    ? obj[key].replace(/<script>/g, "<$cript>").replace(/<\/script>/g, "</$cript>")
-                                    : obj[key];
-                            } else {
-                                newObj[key] = obj[key];
-                            }
-                        }
-                    }
-            
-                    return newObj;
-                });
+  }
+
+  #loadReportHelpers() {
+    handlebars.registerHelper(
+      'getTestsByStatus',
+      (tests, status) => tests.filter(test => test.status.toLowerCase() === status.toLowerCase()).length,
+    );
+
+    handlebars.registerHelper('json', tests => {
+
+      // TODO: please refactor the code below, add meaningful variable names, separate into functions
+      function replaceScriptTagsInArray(array) {
+        return array.map(obj => {
+          const keysToCheck = ['steps', 'stack', 'title', 'suite_title', 'message', 'code'];
+          const newObj = {};
+
+          for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+              if (key === 'example') {
+                newObj[key] = {};
+                for (const subKey in obj[key]) {
+                  if (Object.prototype.hasOwnProperty.call(obj[key], subKey)) {
+                    newObj[key][subKey] =
+                      typeof obj[key][subKey] === 'string'
+                        ? obj[key][subKey].replace(/<script>/g, '<$cript>').replace(/<\/script>/g, '</$cript>')
+                        : obj[key][subKey];
+                  }
+                }
+              } else if (keysToCheck.includes(key)) {
+                newObj[key] =
+                  typeof obj[key] === 'string'
+                    ? obj[key].replace(/<script>/g, '<$cript>').replace(/<\/script>/g, '</$cript>')
+                    : obj[key];
+              } else {
+                newObj[key] = obj[key];
+              }
             }
+          }
 
-            // Remove ANSI escape codes
-            return JSON.stringify(replaceScriptTagsInArray(tests));
+          return newObj;
         });
-    }
+      }
 
-    toString() {
-        return 'HTML Reporter';
-    }
+      // Remove ANSI escape codes
+      return JSON.stringify(replaceScriptTagsInArray(tests));
+    });
+  }
+
+  toString() {
+    return 'HTML Reporter';
+  }
 }
 
 /**
@@ -259,14 +261,14 @@ class HtmlPipe {
  * @returns {string} - The total execution time in a formatted duration string.
  */
 function testExecutionSumTime(tests) {
-    const totalMilliseconds = tests.reduce((sum, test) => {
-        if (typeof test.run_time === 'number') {
-            return sum + test.run_time;
-        }
-        return sum;
-    }, 0);
+  const totalMilliseconds = tests.reduce((sum, test) => {
+    if (typeof test.run_time === 'number') {
+      return sum + test.run_time;
+    }
+    return sum;
+  }, 0);
 
-    return formatDuration(totalMilliseconds);
+  return formatDuration(totalMilliseconds);
 }
 
 /**
@@ -275,10 +277,10 @@ function testExecutionSumTime(tests) {
  * @returns {string} - The updated string with removed ANSI color codes and replaced newline characters.
  */
 function removeAnsiColorCodes(str) {
-    let updatedStr = str.replace(ansiRegExp(), "");        
-    updatedStr = updatedStr.replace(/\n/g, '<br>');
+  let updatedStr = str.replace(ansiRegExp(), '');
+  updatedStr = updatedStr.replace(/\n/g, '<br>');
 
-    return updatedStr;
+  return updatedStr;
 }
 
 /**
@@ -287,14 +289,14 @@ function removeAnsiColorCodes(str) {
  * @returns {string} - The formatted duration string (e.g., "2h 30m 15s 500ms").
  */
 function formatDuration(duration) {
-    const milliseconds = duration % 1000;
-    duration = (duration - milliseconds) / 1000;
-    const seconds = duration % 60;
-    duration = (duration - seconds) / 60;
-    const minutes = duration % 60;
-    const hours = (duration - minutes) / 60;
-
-    return `${hours}h ${minutes}m ${seconds}s ${milliseconds}ms`;
+  const milliseconds = duration % 1000;
+  duration = (duration - milliseconds) / 1000;
+  const seconds = duration % 60;
+  duration = (duration - seconds) / 60;
+  const minutes = duration % 60;
+  const hours = (duration - minutes) / 60;
+
+  return `${hours}h ${minutes}m ${seconds}s ${milliseconds}ms`;
 }
 
 /**
@@ -302,15 +304,15 @@ function formatDuration(duration) {
  * @returns {string} - The formatted date and time string (e.g., "(01/01/2023 12:00:00)").
  */
 function getCurrentDateTimeFormatted() {
-    const currentDate = new Date();
-    const day = currentDate.getDate().toString().padStart(2, '0');
-    const month = (currentDate.getMonth() + 1).toString().padStart(2, '0');
-    const year = currentDate.getFullYear();
-    const hours = currentDate.getHours().toString().padStart(2, '0');
-    const minutes = currentDate.getMinutes().toString().padStart(2, '0');
-    const seconds = currentDate.getSeconds().toString().padStart(2, '0');
-
-    return `(${day}/${month}/${year} ${hours}:${minutes}:${seconds})`;
+  const currentDate = new Date();
+  const day = currentDate.getDate().toString().padStart(2, '0');
+  const month = (currentDate.getMonth() + 1).toString().padStart(2, '0');
+  const year = currentDate.getFullYear();
+  const hours = currentDate.getHours().toString().padStart(2, '0');
+  const minutes = currentDate.getMinutes().toString().padStart(2, '0');
+  const seconds = currentDate.getSeconds().toString().padStart(2, '0');
+
+  return `(${day}/${month}/${year} ${hours}:${minutes}:${seconds})`;
 }
 
-module.exports = HtmlPipe;
+module.exports = HtmlPipe;