artes 1.2.28 → 1.3.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`                                            |
+| 📱 `--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,156 @@
+# 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

@@ -43,6 +43,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 +62,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 +122,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

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.28",
+  "version": "1.3.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

@@ -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/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/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

@@ -151,7 +151,7 @@ After(async function ({ pickle, result }) {
     const screenshotBuffer = await context.page.screenshot({ type: "png" });
 
     await allure.attachment(
-      pickle.name.replaceAll(" ", "_"), 
+      "Screenshot", 
       screenshotBuffer,                             
       "image/png"
     );
@@ -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");