artes 1.3.1 → 1.4.1

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/stepDefinitions.md

@@ -270,6 +270,7 @@
 # Debugging / Console Output
 
 - User wants to see saved variables
+- User wants to see {string} variable
 - User wants to see request body
 - User wants to see response body
 

package/executer.js

@@ -7,7 +7,7 @@ const {
   generateReport,
   cleanUp,
 } = require("./src/helper/executers/exporter");
-const { logPomWarnings }  = require("./src/helper/controller/pomCollector");
+const { logPomWarnings } = require("./src/helper/controller/pomCollector");
 const fs = require("fs");
 const path = require("path");
 
@@ -44,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"),
@@ -123,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)) : "";
 
@@ -148,7 +152,7 @@ function main() {
   if (flags.create) return createProject(flags.createYes, flags.noDeps);
 
   runTests();
-  
+
   logPomWarnings();
 
   if (

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.1",
+  "version": "1.4.1",
   "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

@@ -4,7 +4,6 @@ const fs = require("fs");
 const path = require("path");
 const { moduleConfig } = require("../../helper/imports/commons");
 
-
 const duplicateWarnings = [];
 const keyRegistry = {};
 
@@ -27,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;
@@ -37,35 +36,47 @@ function pomCollector() {
     addElements(parsed);
   });
 
-  const duplicationFilePath = path.join(moduleConfig.projectPath,"node_modules","artes","pomDuplicateWarnings.json")
+  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"
+      "utf8",
     );
   }
 }
 
 function logPomWarnings() {
-
-  if (!fs.existsSync(path.join(moduleConfig.modulePath,"pomDuplicateWarnings.json"))) return;
+  if (
+    !fs.existsSync(
+      path.join(moduleConfig.modulePath, "pomDuplicateWarnings.json"),
+    )
+  )
+    return;
 
   const duplicateWarnings = JSON.parse(
-    fs.readFileSync(path.join(moduleConfig.modulePath,"pomDuplicateWarnings.json"), "utf8")
+    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;
@@ -50,7 +50,7 @@ module.exports = {
   resolveVariable,
   random,
   time,
-  page,
+  browserPage,
   request,
   context,
   moduleConfig,

package/src/helper/stepFunctions/APIActions.js

@@ -197,9 +197,11 @@ async function responseMaker(request, response, duration, curlCommand) {
 }
 
 const api = {
-  get: async (url, payload) => {
+  get: async (url, payload, options) => {
     const URL = await selector(url);
 
+    options = options ?? {};
+
     const resolvedPayload = (await payload) && resolveVariable(payload);
     const payloadJSON = (await resolvedPayload) && JSON.parse(resolvedPayload);
 
@@ -207,7 +209,7 @@ const api = {
 
     const requestStarts = performance.now();
 
-    const res = await context.request.get(URL, req);
+    const res = await context.request.get(URL, req, options);
 
     const duration = performance.now() - requestStarts;
 
@@ -223,12 +225,14 @@ const api = {
 
     context.response = await response;
   },
-  head: async (url) => {
+  head: async (url, options) => {
     const URL = await selector(url);
 
+    options = options ?? {};
+
     const requestStarts = performance.now();
 
-    const res = await context.request.head(URL);
+    const res = await context.request.head(URL, options);
 
     const duration = performance.now() - requestStarts;
 
@@ -238,9 +242,11 @@ const api = {
 
     context.response = await response;
   },
-  post: async (url, payload, requestDataType) => {
+  post: async (url, payload, requestDataType, options) => {
     const URL = await selector(url);
 
+    options = options ?? {};
+
     const resolvedPayload = (await payload) && resolveVariable(payload);
     const payloadJSON = (await resolvedPayload) && JSON.parse(resolvedPayload);
 
@@ -285,7 +291,7 @@ const api = {
 
     const requestStarts = performance.now();
 
-    const res = await context.request.post(URL, req);
+    const res = await context.request.post(URL, req, options);
 
     const duration = performance.now() - requestStarts;
 
@@ -306,9 +312,11 @@ const api = {
 
     context.response = response;
   },
-  put: async (url, payload, requestDataType) => {
+  put: async (url, payload, requestDataType, options) => {
     const URL = await selector(url);
 
+    options = options ?? {};
+
     const resolvedPayload = (await payload) && resolveVariable(payload);
     const payloadJSON = (await resolvedPayload) && JSON.parse(resolvedPayload);
 
@@ -353,7 +361,7 @@ const api = {
 
     const requestStarts = performance.now();
 
-    const res = await context.request.put(URL, req);
+    const res = await context.request.put(URL, req, options);
 
     const duration = performance.now() - requestStarts;
 
@@ -374,9 +382,11 @@ const api = {
 
     context.response = response;
   },
-  patch: async (url, payload, requestDataType) => {
+  patch: async (url, payload, requestDataType, options) => {
     const URL = await selector(url);
 
+    options = options ?? {};
+
     const resolvedPayload = (await payload) && resolveVariable(payload);
     const payloadJSON = (await resolvedPayload) && JSON.parse(resolvedPayload);
 
@@ -421,7 +431,7 @@ const api = {
 
     const requestStarts = performance.now();
 
-    const res = await context.request.patch(URL, req);
+    const res = await context.request.patch(URL, req, options);
 
     const duration = performance.now() - requestStarts;
 
@@ -442,9 +452,11 @@ const api = {
 
     context.response = response;
   },
-  delete: async (url, payload) => {
+  delete: async (url, payload, options) => {
     const URL = await selector(url);
 
+    options = options ?? {};
+
     const resolvedPayload = (await payload) && resolveVariable(payload);
     const payloadJSON = (await resolvedPayload) && JSON.parse(resolvedPayload);
 
@@ -455,7 +467,7 @@ const api = {
 
     const requestStarts = performance.now();
 
-    const res = await context.request.delete(URL, req);
+    const res = await context.request.delete(URL, req, options);
 
     const duration = performance.now() - requestStarts;
 
@@ -471,8 +483,12 @@ const api = {
 
     context.response = await response;
   },
-  vars: () => {
-    return context.vars;
+  vars: (variable) => {
+    if(!variable){
+      return context.vars;
+    }else{
+      return { [variable]: context.vars[variable] };
+    }
   },
 };