snapshot of https://github.com/mattermost/mattermost.git (master, 2026-09-16; blobs > 131072B omitted)

e2e-tests/cypress/run_test_cycle.js

@@ -0,0 +1,273 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+
+/* eslint-disable no-console */
+
+/*
+ * This command, which is normally used in CI, runs Cypress test in full or partial
+ * depending on test metadata and environment capabilities.
+ * Spec file to run is dependent from Test Automation Dashboard and each test result is being
+ * recorded on a per spec file basis.
+ *
+ * Usage: [ENVIRONMENT] node run_test_cycle.js
+ *
+ * Environment:
+ *   AUTOMATION_DASHBOARD_URL   : Dashboard URL
+ *   AUTOMATION_DASHBOARD_TOKEN : Dashboard token
+ *   REPO                       : Project repository, ex. mattermost-webapp
+ *   BRANCH                     : Branch identifier from CI
+ *   BUILD_ID                   : Build identifier from CI
+ *   CI_BASE_URL                : Test server base URL in CI
+ *
+ * Example:
+ * 1. "node run_test_cycle.js"
+ *      - will run all the specs available from the Automation dashboard
+ */
+
+const chalk = require('chalk').default;
+const cypress = require('cypress');
+
+const {
+    getSpecToTest,
+    recordSpecResult,
+    updateCycle,
+    uploadScreenshot,
+} = require('./utils/dashboard');
+const {writeJsonToFile} = require('./utils/report');
+const {MOCHAWESOME_REPORT_DIR, RESULTS_DIR} = require('./utils/constants');
+
+require('dotenv').config();
+
+const {
+    BRANCH,
+    BROWSER,
+    BUILD_ID,
+    CI_BASE_URL,
+    HEADLESS,
+    REPO,
+} = process.env;
+
+async function runCypressTest(specExecution) {
+    const browser = BROWSER || 'chrome';
+    const headless = isHeadless();
+
+    const result = await cypress.run({
+        browser,
+        headless,
+        spec: specExecution.file,
+        config: {
+            screenshotsFolder: `${MOCHAWESOME_REPORT_DIR}/screenshots`,
+            videosFolder: `${MOCHAWESOME_REPORT_DIR}/videos`,
+            trashAssetsBeforeRuns: false,
+        },
+        reporter: 'cypress-multi-reporters',
+        reporterOptions: {
+            reporterEnabled: 'mocha-junit-reporter, mochawesome',
+            mochaJunitReporterReporterOptions: {
+                mochaFile: 'results/junit/test_results[hash].xml',
+                toConsole: false,
+            },
+            mochawesomeReporterOptions: {
+                reportDir: MOCHAWESOME_REPORT_DIR,
+                reportFilename: `json/${specExecution.file}`,
+                quiet: true,
+                overwrite: false,
+                html: false,
+                json: true,
+                testMeta: {
+                    browser,
+                    headless,
+                    branch: BRANCH,
+                    buildId: BUILD_ID,
+                },
+            },
+        },
+    });
+
+    return result;
+}
+
+async function saveResult(specExecution, result, testIndex) {
+    // Write and update test environment details once
+    if (testIndex === 0) {
+        const environment = {
+            cypress_version: result.cypressVersion,
+            browser_name: result.browserName,
+            browser_version: result.browserVersion,
+            headless: isHeadless(),
+            os_name: result.osName,
+            os_version: result.osVersion,
+            node_version: process.version,
+        };
+
+        writeJsonToFile(environment, 'environment.json', RESULTS_DIR);
+        await updateCycle(specExecution.cycle_id, environment);
+    }
+
+    const {stats, tests, spec} = result.runs[0];
+
+    const specPatch = {
+        file: spec.relative,
+        tests: spec.tests,
+        pass: stats.passes,
+        fail: stats.failures,
+        pending: stats.pending,
+        skipped: stats.skipped,
+        duration: stats.duration || 0,
+        test_start_at: stats.startedAt,
+        test_end_at: stats.endedAt,
+    };
+
+    const testCases = [];
+    for (let i = 0; i < tests.length; i++) {
+        const test = tests[i];
+        const attempts = test.attempts.pop();
+
+        const testCase = {
+            title: test.title,
+            full_title: test.title.join(' '),
+            state: attempts.state,
+            duration: attempts.duration || 0,
+            code: trimToMaxLength(test.body),
+        };
+
+        if (attempts.startedAt) {
+            testCase.test_start_at = attempts.startedAt;
+        }
+
+        if (test.displayError) {
+            testCase.error_display = trimToMaxLength(test.displayError);
+        }
+
+        const errorFrame = attempts.error && attempts.error.codeFrame && attempts.error.codeFrame.frame;
+        if (errorFrame) {
+            testCase.error_frame = trimToMaxLength(errorFrame);
+        }
+
+        if (attempts.screenshots && attempts.screenshots.length > 0) {
+            const path = attempts.screenshots[0].path;
+            const screenshotUrl = await uploadScreenshot(path, REPO, BRANCH, BUILD_ID);
+            if (typeof screenshotUrl === 'string' && !screenshotUrl.error) {
+                testCase.screenshot = {url: screenshotUrl};
+            }
+        }
+
+        testCases.push(testCase);
+    }
+
+    await recordSpecResult(specExecution.id, specPatch, testCases);
+}
+
+function isHeadless() {
+    return typeof HEADLESS === 'undefined' ? true : HEADLESS === 'true';
+}
+
+function trimToMaxLength(text) {
+    const maxLength = 5000;
+    return text && text.length > maxLength ? text.substring(0, maxLength) : text;
+}
+
+function printSummary(summary) {
+    const obj = summary.reduce((acc, item) => {
+        const {server, state, count} = item;
+        if (!server) {
+            return acc;
+        }
+
+        if (acc[server]) {
+            acc[server][state] = count;
+        } else {
+            acc[server] = {[state]: count, server};
+        }
+
+        return acc;
+    }, {});
+
+    Object.values(obj).sort((a, b) => {
+        return a.server.localeCompare(b.server);
+    }).forEach((item) => {
+        const {server, done, started} = item;
+        console.log(chalk.magenta(`${server}: done: ${done || 0}, started: ${started || 0}`));
+    });
+}
+
+const maxRetryCount = 5;
+async function runSpecFragment(count, retry) {
+    console.log(chalk.magenta(`Preparing for: ${count + 1}`));
+
+    const spec = await getSpecToTest({
+        repo: REPO,
+        branch: BRANCH,
+        build: BUILD_ID,
+        server: CI_BASE_URL,
+    });
+
+    // Retry on connection/timeout errors
+    if (!spec || spec.code) {
+        if (retry >= maxRetryCount) {
+            return {
+                tryNext: false,
+                count,
+                message: `Test ended due to multiple (${retry}) connection/timeout errors with the dashboard server.`,
+            };
+        }
+
+        console.log(chalk.red(`Retry count: ${retry}`));
+        return runSpecFragment(count, retry + 1);
+    }
+
+    if (!spec.execution || !spec.execution.file) {
+        return {
+            tryNext: false,
+            count,
+            message: spec.message,
+        };
+    }
+
+    const currentTestCount = spec.summary.reduce((total, item) => {
+        return total + parseInt(item.count, 10);
+    }, 0);
+
+    printSummary(spec.summary);
+    console.log(chalk.magenta(`\n(Testing ${currentTestCount} of ${spec.cycle.specs_registered}) - ${spec.execution.file}`));
+    console.log(chalk.magenta(`At "${process.env.CI_BASE_URL}" server`));
+
+    const result = await runCypressTest(spec.execution);
+    await saveResult(spec.execution, result, count);
+
+    const newCount = count + 1;
+
+    if (spec.cycle.specs_registered === currentTestCount) {
+        return {
+            tryNext: false,
+            count: newCount,
+            message: `Completed testing of all registered ${currentTestCount} spec/s.`,
+        };
+    }
+
+    return {
+        tryNext: true,
+        count: newCount,
+        retry: 0,
+        message: 'Continue testing',
+    };
+}
+
+async function runSpec(count = 0, retry = 0) {
+    const fragment = await runSpecFragment(count, retry);
+    if (fragment.tryNext) {
+        return runSpec(fragment.count, fragment.retry);
+    }
+
+    return {
+        count: fragment.count,
+        message: fragment.message,
+    };
+}
+
+runSpec().then(({count, message}) => {
+    console.log(chalk.magenta(message));
+    if (count > 0) {
+        console.log(chalk.magenta(`This test runner has completed ${count} spec file/s.`));
+    }
+});