artes 1.3.0 → 1.4.0

package/README.md

@@ -126,6 +126,7 @@ npx artes [options]
 | 🎭 `--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`                                            |
+| `--offline`               | Run browser in offline mode                                                        | `artes --offline` |
 | 📱 `--device`             | Emulate specific device (e.g., "iPhone 13")                                        | `artes --device "iPhone 13"`   |
 | 🔗 `--baseURL`            | Set base URL for the tests                                                         | `artes --baseURL "https://example.com"`                               |
 | 🖥️ `--maxScreen`          | Maximize browser window on launch                                                  | `artes --maxScreen`                                                   |
@@ -589,6 +590,8 @@ Artes supports environment-specific configurations through environment variables
 | `browserType` | `"chrome"`                     | Browser type (`"chrome"`, `"firefox"`, or `"webkit"`). |
 | `viewport`    | `{ width: 1280, height: 720 }` | Browser viewport size.                                 |
 | `headless`    | `true`                         | Run browser in headless mode (`true` or `false`).      |
+| `offline`     | `false`                        | Run browser in offline mode (`true` or `false`).       |
+
 
 ### Device Configuration
 

package/cucumber.config.js

@@ -164,8 +164,11 @@ module.exports = {
       ? JSON.parse(process.env.BROWSER)
       : artesConfig?.browser || "chrome",
     device: process.env.DEVICE
-    ? JSON.parse(process.env.DEVICE)
-    : artesConfig?.device || null,
+      ? JSON.parse(process.env.DEVICE)
+      : artesConfig?.device || null,
+    offline: process.env.OFFLINE
+      ? JSON.parse(process.env.OFFLINE)
+      : artesConfig?.offline || false,
     viewport: {
       width: process.env.WIDTH
         ? Number(process.env.WIDTH)

package/docs/emulationDevicesList.md

@@ -13,144 +13,141 @@
 
 ## Mobile Devices
 
-- "Blackberry PlayBook"
-- "Blackberry PlayBook landscape"
-- "BlackBerry Z30"
-- "BlackBerry Z30 landscape"
-- "Galaxy Note 3"
-- "Galaxy Note 3 landscape"
-- "Galaxy Note II"
-- "Galaxy Note II landscape"
-- "Galaxy S III"
-- "Galaxy S III landscape"
-- "Galaxy S5"
-- "Galaxy S5 landscape"
-- "Galaxy S8"
-- "Galaxy S8 landscape"
-- "Galaxy S9+"
-- "Galaxy S9+ landscape"
-- "Galaxy Tab S4"
-- "Galaxy Tab S4 landscape"
-- "iPad (gen 5)"
-- "iPad (gen 5) landscape"
-- "iPad (gen 6)"
-- "iPad (gen 6) landscape"
-- "iPad (gen 7)"
-- "iPad (gen 7) landscape"
-- "iPad Mini"
-- "iPad Mini landscape"
-- "iPad Pro 11"
-- "iPad Pro 11 landscape"
-- "iPhone 6"
-- "iPhone 6 landscape"
-- "iPhone 6 Plus"
-- "iPhone 6 Plus landscape"
-- "iPhone 7"
-- "iPhone 7 landscape"
-- "iPhone 7 Plus"
-- "iPhone 7 Plus landscape"
-- "iPhone 8"
-- "iPhone 8 landscape"
-- "iPhone 8 Plus"
-- "iPhone 8 Plus landscape"
-- "iPhone SE"
-- "iPhone SE landscape"
-- "iPhone X"
-- "iPhone X landscape"
-- "iPhone XR"
-- "iPhone XR landscape"
-- "iPhone 11"
-- "iPhone 11 landscape"
-- "iPhone 11 Pro"
-- "iPhone 11 Pro landscape"
-- "iPhone 11 Pro Max"
-- "iPhone 11 Pro Max landscape"
-- "iPhone 12"
-- "iPhone 12 landscape"
-- "iPhone 12 Pro"
-- "iPhone 12 Pro landscape"
-- "iPhone 12 Pro Max"
-- "iPhone 12 Pro Max landscape"
-- "iPhone 12 Mini"
-- "iPhone 12 Mini landscape"
-- "iPhone 13"
-- "iPhone 13 landscape"
-- "iPhone 13 Pro"
-- "iPhone 13 Pro landscape"
-- "iPhone 13 Pro Max"
-- "iPhone 13 Pro Max landscape"
-- "iPhone 13 Mini"
-- "iPhone 13 Mini landscape"
-- "iPhone 14"
-- "iPhone 14 landscape"
-- "iPhone 14 Plus"
-- "iPhone 14 Plus landscape"
-- "iPhone 14 Pro"
-- "iPhone 14 Pro landscape"
-- "iPhone 14 Pro Max"
-- "iPhone 14 Pro Max landscape"
-- "iPhone 15"
-- "iPhone 15 landscape"
-- "iPhone 15 Plus"
-- "iPhone 15 Plus landscape"
-- "iPhone 15 Pro"
-- "iPhone 15 Pro landscape"
-- "iPhone 15 Pro Max"
-- "iPhone 15 Pro Max landscape"
-- "Kindle Fire HDX"
-- "Kindle Fire HDX landscape"
-- "LG Optimus L70"
-- "LG Optimus L70 landscape"
-- "Microsoft Lumia 550"
-- "Microsoft Lumia 550 landscape"
-- "Microsoft Lumia 950"
-- "Microsoft Lumia 950 landscape"
-- "Nexus 10"
-- "Nexus 10 landscape"
-- "Nexus 4"
-- "Nexus 4 landscape"
-- "Nexus 5"
-- "Nexus 5 landscape"
-- "Nexus 5X"
-- "Nexus 5X landscape"
-- "Nexus 6"
-- "Nexus 6 landscape"
-- "Nexus 6P"
-- "Nexus 6P landscape"
-- "Nexus 7"
-- "Nexus 7 landscape"
-- "Nokia Lumia 520"
-- "Nokia Lumia 520 landscape"
-- "Nokia N9"
-- "Nokia N9 landscape"
-- "Pixel 2"
-- "Pixel 2 landscape"
-- "Pixel 2 XL"
-- "Pixel 2 XL landscape"
-- "Pixel 3"
-- "Pixel 3 landscape"
-- "Pixel 4"
-- "Pixel 4 landscape"
-- "Pixel 4a (5G)"
-- "Pixel 4a (5G) landscape"
-- "Pixel 5"
-- "Pixel 5 landscape"
-- "Pixel 7"
-- "Pixel 7 landscape"
-- "Moto G4"
-- "Moto G4 landscape"
+- Blackberry PlayBook
+- Blackberry PlayBook landscape
+- BlackBerry Z30
+- BlackBerry Z30 landscape
+- Galaxy Note 3
+- Galaxy Note 3 landscape
+- Galaxy Note II
+- Galaxy Note II landscape
+- Galaxy S III
+- Galaxy S III landscape
+- Galaxy S5
+- Galaxy S5 landscape
+- Galaxy S8
+- Galaxy S8 landscape
+- Galaxy S9+
+- Galaxy S9+ landscape
+- Galaxy Tab S4
+- Galaxy Tab S4 landscape
+- iPad (gen 5)
+- iPad (gen 5) landscape
+- iPad (gen 6)
+- iPad (gen 6) landscape
+- iPad (gen 7)
+- iPad (gen 7) landscape
+- iPad Mini
+- iPad Mini landscape
+- iPad Pro 11
+- iPad Pro 11 landscape
+- iPhone 6
+- iPhone 6 landscape
+- iPhone 6 Plus
+- iPhone 6 Plus landscape
+- iPhone 7
+- iPhone 7 landscape
+- iPhone 7 Plus
+- iPhone 7 Plus landscape
+- iPhone 8
+- iPhone 8 landscape
+- iPhone 8 Plus
+- iPhone 8 Plus landscape
+- iPhone SE
+- iPhone SE landscape
+- iPhone X
+- iPhone X landscape
+- iPhone XR
+- iPhone XR landscape
+- iPhone 11
+- iPhone 11 landscape
+- iPhone 11 Pro
+- iPhone 11 Pro landscape
+- iPhone 11 Pro Max
+- iPhone 11 Pro Max landscape
+- iPhone 12
+- iPhone 12 landscape
+- iPhone 12 Pro
+- iPhone 12 Pro landscape
+- iPhone 12 Pro Max
+- iPhone 12 Pro Max landscape
+- iPhone 12 Mini
+- iPhone 12 Mini landscape
+- iPhone 13
+- iPhone 13 landscape
+- iPhone 13 Pro
+- iPhone 13 Pro landscape
+- iPhone 13 Pro Max
+- iPhone 13 Pro Max landscape
+- iPhone 13 Mini
+- iPhone 13 Mini landscape
+- iPhone 14
+- iPhone 14 landscape
+- iPhone 14 Plus
+- iPhone 14 Plus landscape
+- iPhone 14 Pro
+- iPhone 14 Pro landscape
+- iPhone 14 Pro Max
+- iPhone 14 Pro Max landscape
+- iPhone 15
+- iPhone 15 landscape
+- iPhone 15 Plus
+- iPhone 15 Plus landscape
+- iPhone 15 Pro
+- iPhone 15 Pro landscape
+- iPhone 15 Pro Max
+- iPhone 15 Pro Max landscape
+- Kindle Fire HDX
+- Kindle Fire HDX landscape
+- LG Optimus L70
+- LG Optimus L70 landscape
+- Microsoft Lumia 550
+- Microsoft Lumia 550 landscape
+- Microsoft Lumia 950
+- Microsoft Lumia 950 landscape
+- Nexus 10
+- Nexus 10 landscape
+- Nexus 4
+- Nexus 4 landscape
+- Nexus 5
+- Nexus 5 landscape
+- Nexus 5X
+- Nexus 5X landscape
+- Nexus 6
+- Nexus 6 landscape
+- Nexus 6P
+- Nexus 6P landscape
+- Nexus 7
+- Nexus 7 landscape
+- Nokia Lumia 520
+- Nokia Lumia 520 landscape
+- Nokia N9
+- Nokia N9 landscape
+- Pixel 2
+- Pixel 2 landscape
+- Pixel 2 XL
+- Pixel 2 XL landscape
+- Pixel 3
+- Pixel 3 landscape
+- Pixel 4
+- Pixel 4 landscape
+- Pixel 4a (5G)
+- Pixel 4a (5G) landscape
+- Pixel 5
+- Pixel 5 landscape
+- Pixel 7
+- Pixel 7 landscape
+- Moto G4
+- Moto G4 landscape
 
 ---
 
 ## Desktop Devices
 
-- "Desktop Chrome HiDPI"
-- "Desktop Edge HiDPI"
-- "Desktop Firefox HiDPI"
-- "Desktop Safari"
-- "Desktop Chrome"
-- "Desktop Edge"
-- "Desktop Firefox"
-
-
-
+- Desktop Chrome HiDPI
+- Desktop Edge HiDPI
+- Desktop Firefox HiDPI
+- Desktop Safari
+- Desktop Chrome
+- Desktop Edge
+- Desktop Firefox

package/executer.js

@@ -7,6 +7,7 @@ const {
   generateReport,
   cleanUp,
 } = require("./src/helper/executers/exporter");
+const { logPomWarnings } = require("./src/helper/controller/pomCollector");
 const fs = require("fs");
 const path = require("path");
 
@@ -43,6 +44,7 @@ const flags = {
   dryRun: args.includes("--dryRun"),
   percentage: args.includes("--percentage"),
   browser: args.includes("--browser"),
+  offline: args.includes("--offline"),
   device: args.includes("--device"),
   baseURL: args.includes("--baseURL"),
   maximizeScreen: args.includes("--maxScreen"),
@@ -122,6 +124,9 @@ flags.percentage ? (process.env.PERCENTAGE = percentage) : "";
 flags.browser && console.log("Running browser:", browser);
 flags.browser ? (process.env.BROWSER = JSON.stringify(browser)) : "";
 
+flags.browser && console.log("Running mode:", flags.offline && "Offline");
+flags.offline ? (process.env.OFFLINE = true) : "";
+
 flags.device && console.log("Running device:", device);
 flags.device ? (process.env.DEVICE = JSON.stringify(device)) : "";
 
@@ -147,6 +152,9 @@ function main() {
   if (flags.create) return createProject(flags.createYes, flags.noDeps);
 
   runTests();
+
+  logPomWarnings();
+
   if (
     flags.reportWithTrace ||
     artesConfig.reportWithTrace ||

package/index.js

@@ -8,12 +8,13 @@ const {
   selector,
   saveVar,
   extractVarsFromResponse,
-  page,
+  browserPage,
   request,
   random,
   time,
   resolveVariable,
 } = require("./src/helper/imports/commons");
+
 const {
   keyboard,
   mouse,
@@ -21,6 +22,7 @@ const {
   assert,
   elementInteractions,
   api,
+  page,
 } = require("./src/helper/stepFunctions/exporter");
 
 module.exports = {
@@ -34,6 +36,7 @@ module.exports = {
   extractVarsFromResponse,
   resolveVariable,
   context,
+  browserPage,
   api,
   random,
   time,

package/package.json

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

package/src/helper/contextManager/browserManager.js

@@ -19,7 +19,9 @@ const invokeBrowser = async () => {
     args: [cucumberConfig.browser.maximizeScreen ? "--start-maximized" : ""],
   };
 
-  const browserType = cucumberConfig.browser.device ? "webkit" : cucumberConfig.browser.browserType.toLowerCase() || "chrome";
+  const browserType = cucumberConfig.browser.device
+    ? "webkit"
+    : cucumberConfig.browser.browserType.toLowerCase() || "chrome";
 
   const browserContextOptions = {
     baseURL: baseURL,
@@ -35,6 +37,7 @@ const invokeBrowser = async () => {
       size: cucumberConfig.browser.viewport,
     },
     ignoreHTTPSErrors: true,
+    offline: cucumberConfig.browser.offline,
   };
 
   switch (browserType) {
@@ -53,9 +56,10 @@ const invokeBrowser = async () => {
       );
   }
 
-
   const context = await browser.newContext({
-    ...(cucumberConfig.browser.device ? devices[cucumberConfig.browser.device] : {}),
+    ...(cucumberConfig.browser.device
+      ? devices[cucumberConfig.browser.device]
+      : {}),
     ...browserContextOptions,
   });
 

package/src/helper/controller/pomCollector.js

@@ -2,6 +2,7 @@ const { addElements } = require("./elementController");
 const cucumberConfig = require("../../../cucumber.config");
 const fs = require("fs");
 const path = require("path");
+const { moduleConfig } = require("../../helper/imports/commons");
 
 const duplicateWarnings = [];
 const keyRegistry = {};
@@ -25,7 +26,7 @@ function pomCollector() {
     Object.keys(parsed).forEach((key) => {
       if (keyRegistry[key]) {
         duplicateWarnings.push(
-          `${key} in ${file} has the same key with ${key} in ${keyRegistry[key]}`
+          `${key} in ${file} has the same key with ${key} in ${keyRegistry[key]}`,
         );
       } else {
         keyRegistry[key] = file;
@@ -34,20 +35,48 @@ function pomCollector() {
 
     addElements(parsed);
   });
+
+  const duplicationFilePath = path.join(
+    moduleConfig.projectPath,
+    "node_modules",
+    "artes",
+    "pomDuplicateWarnings.json",
+  );
+
+  if (duplicateWarnings.length > 0) {
+    fs.mkdirSync(path.dirname(duplicationFilePath), { recursive: true });
+    fs.writeFileSync(
+      duplicationFilePath,
+      JSON.stringify(duplicateWarnings, null, 2),
+      "utf8",
+    );
+  }
 }
 
 function logPomWarnings() {
-  if (duplicateWarnings.length === 0) return;
+  if (
+    !fs.existsSync(
+      path.join(moduleConfig.modulePath, "pomDuplicateWarnings.json"),
+    )
+  )
+    return;
+
+  const duplicateWarnings = JSON.parse(
+    fs.readFileSync(
+      path.join(moduleConfig.modulePath, "pomDuplicateWarnings.json"),
+      "utf8",
+    ),
+  );
 
   console.warn(
-    "\n\x1b[33m[WARNING] POM DUPLICATE KEY WARNINGS:  This may break your tests or cause flaky behavior."
-  ); 
-  
+    "\n\x1b[33m[WARNING] POM DUPLICATE KEY WARNINGS:  This may break your tests or cause flaky behavior.",
+  );
+
   duplicateWarnings.forEach((warning) => {
     console.warn(`- ${warning}`);
   });
 
-  console.log("\x1b[0m")
+  console.log("\x1b[0m");
 }
 
 module.exports = { pomCollector, logPomWarnings };

package/src/helper/executers/helper.js

@@ -75,6 +75,9 @@ function showHelp() {
 
             🌐 --browser       Specify browser to use (chromium, firefox, webkit)
                 Usage:   artes --browser chromium
+            
+            --offline       Run browser in offline mode
+                Usage:   artes --offline
 
             📱 --device       Emulate specific device (e.g., "iPhone 13")
                 Usage:   artes --device "iPhone 13"

package/src/helper/executers/projectCreator.js

@@ -66,6 +66,7 @@ function createProject(createYes, noDeps) {
     // backtrace: false,             // boolean - Show full backtrace for errors
     // dryRun: false,                // boolean - Prepare test run without execution
     // browser: "chrome",            // "chrome", "firefox", "webkit"
+    // offline: false,               // boolean - Run browser in offline mode
     // device: "",                   // string - Emulate specific device (e.g., "iPhone 13", for more devices look at the documentation)
     // width: 1280,                  // number - Browser width
     // height: 720,                  // number - Browser height

package/src/helper/executers/testRunner.js

@@ -5,21 +5,17 @@ function runTests() {
   try {
     console.log("🧪 Running tests...");
 
-    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"], {
+      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

@@ -14,7 +14,7 @@ const dayjs = require("dayjs");
 
 const element = getElement;
 const selector = getSelector;
-const page = context.page;
+const browserPage = context.page;
 const request = context.request;
 
 const random = faker;
@@ -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 @rerun.txt testsStatus EXIT_CODE.txt pomDuplicateWarnings.json",
 };
 
 module.exports = {
@@ -50,7 +50,7 @@ module.exports = {
   resolveVariable,
   random,
   time,
-  page,
+  browserPage,
   request,
   context,
   moduleConfig,