artes 1.2.29 → 1.3.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`                                            |
+| 📱 `--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`                                                   |
 | 📏 `--width`              | Set browser width (default is 1280)                                                | `artes --width 1920`                                                  |
@@ -589,6 +590,13 @@ Artes supports environment-specific configurations through environment variables
 | `viewport`    | `{ width: 1280, height: 720 }` | Browser viewport size.                                 |
 | `headless`    | `true`                         | Run browser in headless mode (`true` or `false`).      |
 
+### Device Configuration
+
+| Option        | Default Value                  | Description                                            |
+| ------------- | ------------------------------ | ------------------------------------------------------ |
+| `device`      | `""`                     | [Device List](./docs/emulationDevicesList.md) |
+
+
 ## 📊 Report Generation
 
 Artes can generate Allure reports. After running tests with the `-r` flag, the reports will be stored in the `report` folder in HTML format. You can view them in your browser after the tests complete.

package/cucumber.config.js

@@ -163,6 +163,9 @@ module.exports = {
     browserType: process.env.BROWSER
       ? JSON.parse(process.env.BROWSER)
       : artesConfig?.browser || "chrome",
+    device: process.env.DEVICE
+    ? JSON.parse(process.env.DEVICE)
+    : artesConfig?.device || null,
     viewport: {
       width: process.env.WIDTH
         ? Number(process.env.WIDTH)

package/docs/emulationDevicesList.md

@@ -0,0 +1,153 @@
+# Emulation Supported Devices
+
+> **Important:** Device names must be written **exactly as listed** and enclosed in double quotes (`""`) when used.  
+> Example:
+>
+> ```bash
+> npx artes --device "iPhone 13"
+> ```
+
+> ⚠️ Make sure to **copy the names exactly** including spaces, capital letters, and parentheses when using them.
+
+---
+
+## 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
+
+---
+
+## Desktop Devices
+
+- 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"),
+  device: args.includes("--device"),
   baseURL: args.includes("--baseURL"),
   maximizeScreen: args.includes("--maxScreen"),
   width: args.includes("--width"),
@@ -61,6 +63,7 @@ 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 device = args[args.indexOf("--device") + 1];
 const baseURL = args[args.indexOf("--baseURL") + 1];
 const width = args[args.indexOf("--width") + 1];
 const height = args[args.indexOf("--height") + 1];
@@ -120,6 +123,9 @@ flags.percentage ? (process.env.PERCENTAGE = percentage) : "";
 flags.browser && console.log("Running browser:", browser);
 flags.browser ? (process.env.BROWSER = JSON.stringify(browser)) : "";
 
+flags.device && console.log("Running device:", device);
+flags.device ? (process.env.DEVICE = JSON.stringify(device)) : "";
+
 flags.baseURL ? (process.env.BASE_URL = JSON.stringify(baseURL)) : "";
 
 flags.maximizeScreen
@@ -142,6 +148,9 @@ function main() {
   if (flags.create) return createProject(flags.createYes, flags.noDeps);
 
   runTests();
+  
+  logPomWarnings();
+
   if (
     flags.reportWithTrace ||
     artesConfig.reportWithTrace ||

package/index.js

@@ -39,7 +39,6 @@ module.exports = {
   time,
   page,
   request,
-  api,
   keyboard,
   mouse,
   frame,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "artes",
-  "version": "1.2.29",
+  "version": "1.3.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

@@ -1,4 +1,4 @@
-const { chromium, firefox, webkit } = require("playwright");
+const { chromium, firefox, webkit, devices } = require("playwright");
 const cucumberConfig = require("../../../cucumber.config.js");
 
 const invokeBrowser = async () => {
@@ -19,14 +19,17 @@ const invokeBrowser = async () => {
     args: [cucumberConfig.browser.maximizeScreen ? "--start-maximized" : ""],
   };
 
-  const browserType =
-    cucumberConfig.browser.browserType.toLowerCase() || "chrome";
+  const browserType = cucumberConfig.browser.device ? "webkit" : cucumberConfig.browser.browserType.toLowerCase() || "chrome";
 
   const browserContextOptions = {
     baseURL: baseURL,
-    viewport: cucumberConfig.browser.maximizeScreen
-      ? null
-      : cucumberConfig.browser.viewport,
+    ...(cucumberConfig.browser.device
+      ? {}
+      : {
+          viewport: cucumberConfig.browser.maximizeScreen
+            ? null
+            : cucumberConfig.browser.viewport,
+        }),
     recordVideo: {
       dir: "./test-results/visualReport/",
       size: cucumberConfig.browser.viewport,
@@ -50,7 +53,11 @@ const invokeBrowser = async () => {
       );
   }
 
-  const context = await browser.newContext(browserContextOptions);
+
+  const context = await browser.newContext({
+    ...(cucumberConfig.browser.device ? devices[cucumberConfig.browser.device] : {}),
+    ...browserContextOptions,
+  });
 
   return {
     browser: browser,

package/src/helper/controller/pomCollector.js

@@ -2,6 +2,8 @@ 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 = {};
@@ -34,10 +36,26 @@ 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."

package/src/helper/executers/helper.js

@@ -76,6 +76,9 @@ function showHelp() {
             🌐 --browser       Specify browser to use (chromium, firefox, webkit)
                 Usage:   artes --browser chromium
 
+            📱 --device       Emulate specific device (e.g., "iPhone 13")
+                Usage:   artes --device "iPhone 13"
+
             🌐 --baseURL       Set base URL for the tests
                 Usage:   artes --baseURL "https://example.com"
 

package/src/helper/executers/projectCreator.js

@@ -43,11 +43,11 @@ function createProject(createYes, noDeps) {
   fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
 
   const config = `module.exports = {
-    headless: false, // Set to true for headless browser mode
+    headless: false,                 // Set to true for headless browser mode
 
     // Configuration options:
     // env: "",                      // string - Environment name for tests
-    // testPercentage: 0, // number - Minimum success rate percentage(Default: 0)
+    // testPercentage: 0,            // number - Minimum success rate percentage(Default: 0)
     // baseURL: "",                  // string - Base URL for API tests
     // paths: [],                    // string[] - Paths to feature files
     // steps: "",                    // string - Step definitions files
@@ -55,7 +55,7 @@ function createProject(createYes, noDeps) {
     // timeout : 0,                  // number - Test timeout in seconds
     // slowMo: 0,                    // number - Slow down test execution (Default: 0 seconds)
     // parallel: 0,                  // number - Number of parallel workers
-    // report: true                   / boolean - Generate report
+    // report: true                  // boolean - Generate report
     // reportSuccess: false,         // boolean - Add screenshots and video records to report also for success test cases
     // trace: false,                 // boolean - Enable tracing
     // reportWithTrace: false,       // boolean - Include trace in report
@@ -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"
+    // 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
     // maximizeScreen: true          // boolean - Maximize browser window

package/src/helper/executers/testRunner.js

@@ -1,6 +1,5 @@
 const { spawnSync } = require("child_process");
 const { moduleConfig } = require("../imports/commons");
-const path = require("path");
 
 function runTests() {
   try {

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 @rerun.txt testsStatus EXIT_CODE.txt pomDuplicateWarnings.json",
 };
 
 module.exports = {

package/src/helper/stepFunctions/assertions.js

@@ -336,7 +336,7 @@ const assert = {
     expect(elementInteractions.textContent(selector)).toContain(substring);
   },
   shouldContainEqual: (selector, expected) => {
-    expect(elementInteractions.textContent(selector)).toContainEqual(element);
+    expect(elementInteractions.textContent(selector)).toContainEqual(expected);
   },
   shouldEqual: (selector, expected) => {
     expect(Number(elementInteractions.textContent(selector))).toEqual(expected);
@@ -455,7 +455,7 @@ const assert = {
   shouldNotContainEqual: (selector, expected) => {
     expect(
       Number(elementInteractions.textContent(selector)),
-    ).not.toContainEqual(element);
+    ).not.toContainEqual(expected);
   },
   shouldNotEqual: (selector, expected) => {
     expect(Number(elementInteractions.textContent(selector))).not.toEqual(

package/src/helper/stepFunctions/keyboardActions.js

@@ -1,4 +1,6 @@
 const { element, resolveVariable } = require("../imports/commons");
+const { frame } = require("./frameActions");
+
 
 const keyboard = {
   press: async (selector, key) => {

package/src/hooks/hooks.js

@@ -233,6 +233,8 @@ AfterAll(async () => {
     await projectHooks.AfterAll();
   }
 
+  logPomWarnings();
+  
   if (!fs.existsSync(statusDir)) return;
 
   const files = fs.readdirSync(statusDir);

package/src/stepDefinitions/assertions.steps.js

@@ -5,6 +5,7 @@ const {
   element,
   extractVarsFromResponse,
   context,
+  resolveVariable,
 } = require("../helper/imports/commons");
 const { assert, frame } = require("../helper/stepFunctions/exporter");
 const Ajv = require("ajv");