@sap_oss/wdio-qmate-service 3.9.0 → 3.10.0

package/reuseApi.json

@@ -633,472 +633,6 @@
       }
     }
   },
-  "mobile": {
-    "android": {
-      "pressKeyByName": {
-        "type": "async",
-        "description": "Simulate pressing a hardware key on the android device (e.g., back button, home button, etc.),",
-        "arguments": [
-          {
-            "name": "keyName",
-            "type": "string",
-            "default": null
-          }
-        ],
-        "returnType": "promise"
-      },
-      "pressKeyByCode": {
-        "type": "async",
-        "description": "Simulate pressing a hardware key on the android device (e.g., back button, home button, etc.),",
-        "arguments": [
-          {
-            "name": "keyCode",
-            "type": "string",
-            "default": null
-          }
-        ],
-        "returnType": "promise"
-      }
-    },
-    "device": {
-      "isAppInstalled": {
-        "type": "async",
-        "description": "Check if the application identified by its Package name/Bundle ID is installed on the device.",
-        "arguments": [
-          {
-            "name": "appPackageOrBundleId",
-            "type": "string",
-            "default": null
-          }
-        ],
-        "returnType": "boolean"
-      },
-      "installApp": {
-        "type": "async",
-        "description": "Install the appropriate app based on the platform the test is being executed on.",
-        "arguments": [
-          {
-            "name": "appPath",
-            "type": "string",
-            "default": null
-          }
-        ],
-        "returnType": "promise"
-      },
-      "switchToContext": {
-        "type": "async",
-        "description": "Switch to the specified( WEBVIEW | NATIVE_APP ) context if available.",
-        "arguments": [
-          {
-            "name": "targetContext",
-            "type": "string",
-            "default": "'WEBVIEW'"
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 5000
-          }
-        ],
-        "returnType": "promise"
-      },
-      "getTargetContextIfAvailable": {
-        "type": "async",
-        "description": "Returns the specified target context if available within a given timeout.\n\nThis method retrieves the list of available contexts and determines if a context\nthat matches the `targetContext` string is present. If the target context is found,\nit returns the context name; otherwise, it returns `null`.",
-        "arguments": [
-          {
-            "name": "targetContext",
-            "type": "string",
-            "default": "'WEBVIEW'"
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 5000
-          }
-        ],
-        "returnType": "promise"
-      },
-      "closeApplication": {
-        "type": "async",
-        "description": "Close the currently active mobile application.",
-        "arguments": [],
-        "returnType": "promise"
-      },
-      "queryAppState": {
-        "type": "async",
-        "description": "Queries the state of the application (e.g., running, background, not installed) on the mobile device(Android or iOS).",
-        "arguments": [
-          {
-            "name": "appPackageOrBundleId",
-            "type": "string",
-            "default": null
-          }
-        ],
-        "returnType": "promise"
-      },
-      "launchApp": {
-        "type": "async",
-        "description": "Launches the app for both iOS and Android with a parameterized app identifier.",
-        "arguments": [
-          {
-            "name": "appPackageOrBundleId",
-            "type": "string",
-            "default": null
-          }
-        ],
-        "returnType": "promise"
-      },
-      "switchToLandscapeOrientation": {
-        "type": "async",
-        "description": "Switches the device orientation to landscape mode.",
-        "arguments": [],
-        "returnType": "promise"
-      },
-      "switchToPortraitOrientation": {
-        "type": "async",
-        "description": "Switches the device orientation to portrait mode.",
-        "arguments": [],
-        "returnType": "promise"
-      },
-      "getCurrentOrientation": {
-        "type": "async",
-        "description": "Returns the device current orientation (PORTRAIT or LANDSCAPE)",
-        "arguments": [],
-        "returnType": "promise"
-      },
-      "hideKeyboard": {
-        "type": "async",
-        "description": "Hides the keyboard on both Android and iOS using specific strategies with timeout.",
-        "arguments": [
-          {
-            "name": "strategy",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "key",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "keyCode",
-            "type": "number",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 5000
-          }
-        ],
-        "returnType": "promise"
-      },
-      "isKeyboardVisible": {
-        "type": "async",
-        "description": "Checks if the keyboard is visible or not on the mobile device.",
-        "arguments": [],
-        "returnType": "promise"
-      },
-      "isPlatformSupported": {
-        "type": "async",
-        "description": "Determine if the current platform is supported, if the current device platform is either `Android` or `iOS`.",
-        "arguments": [],
-        "returnType": "promise"
-      }
-    },
-    "element": {
-      "isVisible": {
-        "type": "async",
-        "description": "Returns a boolean if the mobile element is visible to the user.",
-        "arguments": [
-          {
-            "name": "element",
-            "type": "element",
-            "default": null
-          },
-          {
-            "name": "strict",
-            "type": "boolean",
-            "default": true
-          }
-        ],
-        "returnType": "boolean"
-      },
-      "isPresent": {
-        "type": "async",
-        "description": "Returns a boolean if the element is present at the DOM or not. It might be hidden.",
-        "arguments": [
-          {
-            "name": "element",
-            "type": "element",
-            "default": null
-          }
-        ],
-        "returnType": "boolean"
-      },
-      "waitToBePresent": {
-        "type": "async",
-        "description": "Waits until the element with the given selector is present.",
-        "arguments": [
-          {
-            "name": "selector",
-            "type": "object",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ],
-        "returnType": "boolean"
-      },
-      "waitToBeVisible": {
-        "type": "async",
-        "description": "Waits until the element with the given selector is visible.",
-        "arguments": [
-          {
-            "name": "selector",
-            "type": "object",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ],
-        "returnType": "boolean"
-      },
-      "waitToBeClickable": {
-        "type": "async",
-        "description": "Waits until the element with the given selector is clickable.",
-        "arguments": [
-          {
-            "name": "selector",
-            "type": "object",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ],
-        "returnType": "boolean"
-      },
-      "isSelected": {
-        "type": "async",
-        "description": "Returns a boolean if the element (e.g. checkbox) is selected.",
-        "arguments": [
-          {
-            "name": "elementOrSelector",
-            "type": "string",
-            "default": null
-          }
-        ],
-        "returnType": "boolean"
-      },
-      "waitToBeEnabled": {
-        "type": "async",
-        "description": "Waits until the element with the given selector is present.",
-        "arguments": [
-          {
-            "name": "selector",
-            "type": "object",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ],
-        "returnType": "boolean"
-      }
-    },
-    "gestures": {
-      "swipe": {
-        "type": "async",
-        "description": "Swipe from one point to another on the screen,\nEnsure that the provided coordinates are within the bounds of the screen to avoid unexpected behavior.",
-        "arguments": [
-          {
-            "name": "startX",
-            "type": "number",
-            "default": null
-          },
-          {
-            "name": "startY",
-            "type": "number",
-            "default": null
-          },
-          {
-            "name": "endX",
-            "type": "number",
-            "default": null
-          },
-          {
-            "name": "endY",
-            "type": "number",
-            "default": null
-          },
-          {
-            "name": "duration",
-            "type": "number",
-            "default": 1000
-          }
-        ],
-        "returnType": "promise"
-      },
-      "tap": {
-        "type": "async",
-        "description": "Executes a tap at the given screen coordinates,\nEnsure that the provided coordinates are within the bounds of the screen to avoid unexpected behavior.",
-        "arguments": [
-          {
-            "name": "coordX",
-            "type": "number",
-            "default": null
-          },
-          {
-            "name": "coordY",
-            "type": "number",
-            "default": null
-          }
-        ],
-        "returnType": "promise"
-      }
-    },
-    "ios": {},
-    "userInteraction": {
-      "tap": {
-        "type": "async",
-        "description": "Tap's on the mobile element.",
-        "arguments": [
-          {
-            "name": "elementOrSelector",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ]
-      },
-      "check": {
-        "type": "async",
-        "description": "Checks the given checkbox.",
-        "arguments": [
-          {
-            "name": "elementOrSelector",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ]
-      },
-      "uncheck": {
-        "type": "async",
-        "description": "Unchecks the given checkbox.",
-        "arguments": [
-          {
-            "name": "elementOrSelector",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ]
-      },
-      "doubleTap": {
-        "type": "async",
-        "description": "Double Tap's on the mobile element.",
-        "arguments": [
-          {
-            "name": "elementOrSelector",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ],
-        "returnType": "promise"
-      },
-      "fill": {
-        "type": "async",
-        "description": "Enter a string value into a mobile input field.",
-        "arguments": [
-          {
-            "name": "elementOrSelector",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "value",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ],
-        "returnType": "promise"
-      },
-      "clearAndFill": {
-        "type": "async",
-        "description": "Enter a string into the mobile input field; it will clear the box before submission.",
-        "arguments": [
-          {
-            "name": "elementOrSelector",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "value",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ],
-        "returnType": "promise"
-      },
-      "clear": {
-        "type": "async",
-        "description": "Clear a string value into a mobile input field.",
-        "arguments": [
-          {
-            "name": "elementOrSelector",
-            "type": "string",
-            "default": null
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "default": 30000
-          }
-        ],
-        "returnType": "promise"
-      }
-    }
-  },
   "nonUi5": {
     "assertion": {
       "expectAttributeToBe": {
@@ -4467,8 +4001,14 @@
       },
       "expectLogoutText": {
         "type": "async",
-        "description": "Expects the logout text after logout to be \"You have been logged off.\nThis is essential for chaining scripts, so that no static browser sleep in the spec itself is required anymore.",
-        "arguments": []
+        "description": "Expects the logout text after logout. Waits for \"You have been logged off.\" in S4 systems or \"Goodbye\" in BTP systems.\nThis is essential for chaining scripts, so that no static browser sleep in the spec itself is required anymore.",
+        "arguments": [
+          {
+            "name": "timeout",
+            "type": "number",
+            "default": 30000
+          }
+        ]
       }
     },
     "table": {

package/test/helper/configurations/base.conf.js

@@ -3,11 +3,14 @@ const WdioQmateService = require("../../../lib/index.js");
 const chromedriverPath = require("chromedriver").path;
 const fs = require("fs");
 
-if (!process.env.CHROME_DRIVER || !fs.existsSync(process.env.CHROME_DRIVER)) {
+// WDIO 8 reads CHROMEDRIVER_PATH (see @wdio/utils startWebDriver.js / manager.js).
+// Setting it short-circuits WDIO's runtime download to /tmp/chromedriver/... and
+// spawns the binary installed by the npm `chromedriver` package's postinstall.
+if (!process.env.CHROMEDRIVER_PATH || !fs.existsSync(process.env.CHROMEDRIVER_PATH)) {
   if (fs.existsSync(chromedriverPath)) {
-    process.env.CHROME_DRIVER = chromedriverPath;
+    process.env.CHROMEDRIVER_PATH = chromedriverPath;
   } else {
-    console.error("Path to chromedriver bin is wrong." + process.env.CHROME_DRIVER || chromedriverPath);
+    console.error("Path to chromedriver bin is wrong." + (process.env.CHROMEDRIVER_PATH || chromedriverPath));
     process.exit(1);
   }
 }

package/test/helper/configurations/chrome.headless.conf.js

@@ -5,7 +5,7 @@ exports.config = merge(baseConfig.config, {
   capabilities: [
     {
       browserName: "chrome",
-      browserVersion: "138",
+      browserVersion: "149",
       acceptInsecureCerts: true,
       "goog:chromeOptions": {
         args: [

package/test/reuse/ui5/assertion/expectAttributeToBe.spec.js

@@ -1,19 +1,19 @@
 "use strict";
-let selector;
 
 describe("assertion - expectAttributeToBe: title to be 'Laptops' (string)", function () {
+  const selector = {
+    elementProperties: {
+      viewName: "sap.ui.demo.cart.view.Home",
+      metadata: "sap.m.StandardListItem",
+      bindingContextPath: "/ProductCategories*'LT')"
+    }
+  };
+
   it("Preparation", async function () {
     await browser.url("#/categories");
   });
 
   it("Execution", async function () {
-    selector = {
-      elementProperties: {
-        viewName: "sap.ui.demo.cart.view.Home",
-        metadata: "sap.m.StandardListItem",
-        bindingContextPath: "/ProductCategories*'LT')"
-      }
-    };
   });
 
   it("Verification", async function () {
@@ -23,18 +23,19 @@ describe("assertion - expectAttributeToBe: title to be 'Laptops' (string)", func
 });
 
 describe("assertion - expectAttributeToBe wrong/null/undefined", function () {
+  const selector = {
+    elementProperties: {
+      viewName: "sap.ui.demo.cart.view.Home",
+      metadata: "sap.m.StandardListItem",
+      bindingContextPath: "/ProductCategories*'LT')"
+    }
+  };
+
   it("Preparation", async function () {
     await browser.url("#/categories");
   });
 
   it("Execution", async function () {
-    selector = {
-      elementProperties: {
-        viewName: "sap.ui.demo.cart.view.Home",
-        metadata: "sap.m.StandardListItem",
-        bindingContextPath: "/ProductCategories*'LT')"
-      }
-    };
   });
 
   it("Verification", async function () {
@@ -51,18 +52,19 @@ describe("assertion - expectAttributeToBe wrong/null/undefined", function () {
 });
 
 describe("assertion - expectAttributeToBe: 'visible' of the listItem to be true (boolean and as string)", function () {
+  const selector = {
+    elementProperties: {
+      viewName: "sap.ui.demo.cart.view.Home",
+      metadata: "sap.m.StandardListItem",
+      bindingContextPath: "/ProductCategories*'LT')"
+    }
+  };
+
   it("Preparation", async function () {
     await browser.url("#/categories");
   });
 
   it("Execution", async function () {
-    selector = {
-      elementProperties: {
-        viewName: "sap.ui.demo.cart.view.Home",
-        metadata: "sap.m.StandardListItem",
-        bindingContextPath: "/ProductCategories*'LT')"
-      }
-    };
   });
 
   it("Verification", async function () {
@@ -73,18 +75,19 @@ describe("assertion - expectAttributeToBe: 'visible' of the listItem to be true
 });
 
 describe("assertion - expectAttributeToBe: 'busyIndicatorDelay' of the listItem to be 1000 (number and as string)", function () {
+  const selector = {
+    elementProperties: {
+      viewName: "sap.ui.demo.cart.view.Home",
+      metadata: "sap.m.StandardListItem",
+      bindingContextPath: "/ProductCategories*'LT')"
+    }
+  };
+
   it("Preparation", async function () {
     await browser.url("#/categories");
   });
 
   it("Execution", async function () {
-    selector = {
-      elementProperties: {
-        viewName: "sap.ui.demo.cart.view.Home",
-        metadata: "sap.m.StandardListItem",
-        bindingContextPath: "/ProductCategories*'LT')"
-      }
-    };
   });
   it("Verification", async function () {
     await ui5.assertion.expectAttributeToBe(selector, "busyIndicatorDelay", 1000);
@@ -93,4 +96,46 @@ describe("assertion - expectAttributeToBe: 'busyIndicatorDelay' of the listItem
   });
 });
 
+describe("assertion - expectAttributeToBe: 'text' is a text with special spaces characters", function () {
+  const specialSpacesString = "-\u00A0-\u2002-\u2003-\u2007-\u2009-\u202F-";
+  const normalizedString = "- - - - - - -";
+  const selector = {
+    elementProperties: {
+      metadata: "sap.m.Title",
+      id: "container-cart---homeView--page-title"
+    }
+  };
+  
+  it("Preparation", async function () {
+    await browser.url("#/categories");
+    await browser.uiControls(selector);
+    await browser.execute(`sap.ui.getCore().byId("${selector.elementProperties.id}").setText("${specialSpacesString}")`);
+  });
+
+  it("Execution && Verification", async function () {
+    await ui5.assertion.expectAttributeToBe(selector, "text", normalizedString);
+  });
+});
+
+describe("assertion - expectAttributeToBe: 'text' is a text with invisible characters", function () {
+  const invisibleCharacters = "-\u200B-\u200C-\u200D-\uFEFF-";
+  const normalizedString = "-----";
+  const selector = {
+    elementProperties: {
+      metadata: "sap.m.Title",
+      id: "container-cart---homeView--page-title"
+    }
+  };
+  
+  it("Preparation", async function () {
+    await browser.url("#/categories");
+    await browser.uiControls(selector);
+    await browser.execute(`sap.ui.getCore().byId("${selector.elementProperties.id}").setText("${invisibleCharacters}")`);
+  });
+
+  it("Execution && Verification", async function () {
+    await ui5.assertion.expectAttributeToBe(selector, "text", normalizedString);
+  });
+});
+
 // TODO: add check for 'enabled' parameter