artes 1.2.22 → 1.2.24

package/README.md

@@ -122,6 +122,7 @@ npx artes [options]
 | 🕶️ `--headless`           | Run browser in headless mode                                                       | `artes --headless`                                                    |
 | ⚡ `--parallel`           | Run tests in parallel mode                                                         | `artes --parallel 2`                                                  |
 | 🔁 `--retry`              | Retry failed tests                                                                 | `artes --retry 3`                                                     |
+| 🔁 `--rerun`              | Rerun only the failed tests from previous run                                      | `artes --rerun @rerun.txt`                                            |
 | 🎭 `--dryRun`             | Perform a dry run without executing tests                                          | `artes --dryRun`                                                      |
 | 📈 `--percentage`         | Set minimum success percentage to pass test run (default is 0)                     | `artes --percentage 85`                                               |
 | 🌍 `--browser`            | Specify browser to use (`chromium`, `firefox`, or `webkit`)                        | `artes --browser chromium`                                            |

package/cucumber.config.js

@@ -90,11 +90,15 @@ module.exports = {
       ? true
       : artesConfig.reportSuccess || false, // Include successful tests in report
 
-    trace: process.env.TRACE === "true" ? process.env.TRACE : artesConfig.trace || false, // Enable tracing
-
-    reportWithTrace: process.env.REPORT_WITH_TRACE === "true"
-      ? process.env.REPORT_WITH_TRACE
-      : artesConfig.reportWithTrace || false, // Include trace in report
+    trace:
+      process.env.TRACE === "true"
+        ? process.env.TRACE
+        : artesConfig.trace || false, // Enable tracing
+
+    reportWithTrace:
+      process.env.REPORT_WITH_TRACE === "true"
+        ? process.env.REPORT_WITH_TRACE
+        : artesConfig.reportWithTrace || false, // Include trace in report
 
     format: finalFormats, // Formatter names/paths
     formatOptions: artesConfig.formatOptions || {

package/docs/functionDefinitions.md

@@ -434,6 +434,7 @@ await getURL();
 ```
 
 - **Returns**:
+
   - _(string)_: The current page URL.
 
   ***
@@ -655,6 +656,7 @@ await shouldHaveId("#element-id", "unique-id");
 ```
 
 - **Parameters**:
+
   - `id` _(string)_: The expected ID.
 
   Got it! Here’s the refined format for the assertion methods:
@@ -1542,6 +1544,7 @@ await shouldObjectContaining(".element", { key: "value" });
 ```
 
 - **Parameters**:
+
   - `selector` _(string)_: The CSS selector for the element.
   - `properties` _(object)_: The object properties to check for.
 

package/executer.js

@@ -39,6 +39,7 @@ const flags = {
   headless: args.includes("--headless"),
   parallel: args.includes("--parallel"),
   retry: args.includes("--retry"),
+  rerun: args.includes("--rerun"),
   dryRun: args.includes("--dryRun"),
   percentage: args.includes("--percentage"),
   browser: args.includes("--browser"),
@@ -57,6 +58,7 @@ const stepDef = args[args.indexOf("--stepDef") + 1];
 const tags = args[args.indexOf("--tags") + 1];
 const parallel = args[args.indexOf("--parallel") + 1];
 const retry = args[args.indexOf("--retry") + 1];
+const rerun = args[args.indexOf("--rerun") + 1];
 const percentage = args[args.indexOf("--percentage") + 1];
 const browser = args[args.indexOf("--browser") + 1];
 const baseURL = args[args.indexOf("--baseURL") + 1];
@@ -109,6 +111,8 @@ flags.parallel ? (process.env.PARALLEL = parallel) : "";
 
 flags.retry ? (process.env.RETRY = retry) : "";
 
+flags.rerun ? (process.env.RERUN = rerun) : "";
+
 flags.dryRun ? (process.env.DRYRUN = flags.dryRun) : "";
 
 flags.percentage ? (process.env.PERCENTAGE = percentage) : "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "artes",
-  "version": "1.2.22",
+  "version": "1.2.24",
   "description": "The simplest way to automate UI and API tests using Cucumber-style steps.",
   "main": "index.js",
   "scripts": {

package/src/helper/executers/helper.js

@@ -63,6 +63,9 @@ function showHelp() {
       
             🔁 --retry         Retry failed tests
                 Usage:   artes --retry 2
+
+            🔄 --rerun         Rerun only the failed tests from previous run
+                Usage:   artes --rerun @rerun.txt
       
             🎭 --dryRun        Perform a dry run without executing tests
                 Usage:   artes --dryRun

package/src/helper/executers/projectCreator.js

@@ -23,7 +23,7 @@ function createProject(createYes, noDeps) {
   });
 
   if (!noDeps) {
-    execSync("npm i artes", { cwd: projectDir, stdio: "inherit" });
+    execSync("npm i artes@latest", { cwd: projectDir, stdio: "inherit" });
     console.log("📦 Setting up browsers...");
     execSync("npx playwright install", { cwd: projectDir, stdio: "inherit" });
   }
@@ -40,10 +40,6 @@ function createProject(createYes, noDeps) {
     testWithReport: "npx artes -r",
   };
 
-  packageJson.dependencies = {
-    artes: "1.2.21",
-  };
-
   fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
 
   const config = `module.exports = {

package/src/helper/executers/reportGenerator.js

@@ -29,7 +29,6 @@ function generateReport() {
       `📋 Report generated successfully in ${moduleConfig.reportPath}!`,
     );
 
-
     if (fs.existsSync(moduleConfig.reportPath) && process.env.ZIP === "true") {
       console.log(`🗜️ Zipping report folder`);
 
@@ -61,8 +60,7 @@ function generateReport() {
 
       console.log(`🗜️ Zipped in ${moduleConfig.reportPath}/report.zip!`);
       if (error) throw error;
-    } 
-    
+    }
   } catch (err) {
     console.error("❌ Report generation failed:", err);
     process.env.EXIT_CODE = 1;

package/src/helper/executers/testRunner.js

@@ -1,5 +1,6 @@
 const { spawnSync } = require("child_process");
 const { moduleConfig } = require("../imports/commons");
+const path = require("path");
 
 function runTests() {
   try {
@@ -7,17 +8,24 @@ function runTests() {
     process.env.FORCE_COLOR = "1";
     process.env.FORCE_STDIO_TTY = "1";
 
-    spawnSync("cucumber-js", ["--config=cucumber.config.js"], {
-      cwd: moduleConfig.modulePath,
-      stdio: "inherit",
-      shell: true,
-      env: {
-        ...process.env,
-        FORCE_TTY: "1",
-        FORCE_COLOR: "1",
-        CI: "false",
+    spawnSync(
+      "cucumber-js",
+      [
+        "--config=cucumber.config.js",
+        `${process.env.RERUN ? path.join("../../", process.env.RERUN) : ""}`,
+      ],
+      {
+        cwd: moduleConfig.modulePath,
+        stdio: "inherit",
+        shell: true,
+        env: {
+          ...process.env,
+          FORCE_TTY: "1",
+          FORCE_COLOR: "1",
+          CI: "false",
+        },
       },
-    });
+    );
     console.log("✅ Tests running completed successfully!");
   } catch (error) {
     console.error("❌ Test execution failed:", error);

package/src/helper/imports/commons.js

@@ -35,7 +35,7 @@ const moduleConfig = {
   stepsPath: path.join(projectPath, "/tests/steps/*.js"),
   pomPath: path.join(projectPath, "/tests/POMs"),
   cleanUpPaths:
-    "allure-result allure-results test-results @rerun.txt testsStatus EXIT_CODE.txt",
+    "allure-result allure-results test-results testsStatus EXIT_CODE.txt",
 };
 
 module.exports = {

package/src/hooks/hooks.js

@@ -103,7 +103,7 @@ Before(async function () {
 
   await context.page.setDefaultTimeout(cucumberConfig.default.timeout);
 
-  if ( cucumberConfig.default.reportWithTrace || cucumberConfig.default.trace) {
+  if (cucumberConfig.default.reportWithTrace || cucumberConfig.default.trace) {
     await browserContext.tracing.start({
       sources: true,
       screenshots: true,
@@ -142,8 +142,7 @@ After(async function ({ pickle, result }) {
   }
 
   const shouldReport =
-    (cucumberConfig.default.successReport ||
-      result?.status !== Status.PASSED) 
+    cucumberConfig.default.successReport || result?.status !== Status.PASSED;
 
   if (shouldReport) {
     const screenshotPath = path.join(
@@ -164,16 +163,17 @@ After(async function ({ pickle, result }) {
   }
 
   saveTestStatus(result, pickle);
-if((cucumberConfig.default.reportWithTrace || cucumberConfig.default.trace)){
-  var tracePath = path.join(
-    moduleConfig.projectPath,
-    `./traces/${pickle.name.replaceAll(" ", "_")}.zip`,
-  );
-}
-
+  if (cucumberConfig.default.reportWithTrace || cucumberConfig.default.trace) {
+    var tracePath = path.join(
+      moduleConfig.projectPath,
+      `./traces/${pickle.name.replaceAll(" ", "_")}.zip`,
+    );
+  }
 
   if (
-    (cucumberConfig.default.reportWithTrace || cucumberConfig.default.trace) && shouldReport
+    (cucumberConfig.default.reportWithTrace || cucumberConfig.default.trace) &&
+    shouldReport &&
+    context.page.url() !== "about:blank"
   ) {
     await context.browserContext.tracing.stop({
       path: tracePath,
@@ -188,11 +188,19 @@ if((cucumberConfig.default.reportWithTrace || cucumberConfig.default.trace)){
       });
 
       if (!cucumberConfig.default.trace) {
-        spawnSync("npx", ["rimraf", "--no-glob", path.join(moduleConfig.projectPath, "./traces")], {
-          cwd: moduleConfig.projectPath,
-          stdio: "inherit",
-          shell: false,
-        });
+        spawnSync(
+          "npx",
+          [
+            "rimraf",
+            "--no-glob",
+            path.join(moduleConfig.projectPath, "./traces"),
+          ],
+          {
+            cwd: moduleConfig.projectPath,
+            stdio: "inherit",
+            shell: false,
+          },
+        );
       }
     }
   }
@@ -234,6 +242,16 @@ AfterAll(async () => {
   const totalTests = files.length;
   const successPercentage = (passedCount / totalTests) * 100;
 
+  const failed = files.filter((f) => f.split("-")[0] === "FAILED").length;
+
+  if (failed > 0) {
+    spawnSync("mv", ["@rerun.txt", moduleConfig.projectPath], {
+      cwd: path.join(moduleConfig.projectPath, "node_modules", "artes"),
+      stdio: "ignore",
+      shell: true,
+    });
+  }
+
   if (cucumberConfig.default.testPercentage !== undefined) {
     const meetsThreshold =
       successPercentage >= cucumberConfig.default.testPercentage;

package/src/stepDefinitions/API.steps.js

@@ -7,7 +7,6 @@ const {
   random,
 } = require("../helper/imports/commons");
 const { api } = require("../helper/stepFunctions/exporter");
-const Ajv = require("ajv");
 
 When("User sends GET request to {string}", async function (url) {
   await api.get(url);