@sap_oss/wdio-qmate-service 1.0.0

package/test/core/functional/chaining/test.conf.js

@@ -0,0 +1,31 @@
+var path = require("path");
+var merge = require("deepmerge");
+var profile = require("../../../helper/configurations/chrome.headless.conf.js");
+
+exports.config = merge(profile.config, {
+  maxInstances: 6,
+  bail: 1,
+
+  //
+  // ==================
+  // Specify Test Files
+  // ==================
+  // Define which test specs should run. The pattern is relative to the directory
+  // from which `wdio` was called. Notice that, if you are calling `wdio` from an
+  // NPM script (see https://docs.npmjs.com/cli/run-script) then the current working
+  // directory is where your package.json resides, so `wdio` will be called from there.
+  //
+  specs: [
+    path.resolve(__dirname, "chaining.test.js")
+  ],
+  // Patterns to exclude.
+  exclude: [
+    // 'path/to/excluded/files'
+  ],
+  //
+  // Set a base URL in order to shorten url command calls. If your `url` parameter starts
+  // with `/`, the base url gets prepended, not including the path portion of your baseUrl.
+  // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url
+  // gets prepended directly.
+  baseUrl: "https://sapui5.hana.ondemand.com/1.99.0/test-resources/sap/m/demokit/cart/webapp/index.html"
+});

package/test/core/functional/locators/ancestorProperties.test.js

@@ -0,0 +1,99 @@
+"use strict";
+const { handleCookiesConsent } = require("../../../helper/utils");
+
+describe("webdriver.io page locator test", function () {
+  it("should access same element by elementProperties, ancestorProperties and nested ancestorProperties", async function () {
+    await browser.navigateTo(
+      "https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.Button/sample/sap.m.sample.Button"
+    );
+    await handleCookiesConsent();
+
+    const rejectButtonProperties = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.m.Button",
+        "text": "Reject"
+      },
+      "ancestorProperties": {
+        "metadata": "sap.m.FlexItemData",
+        "viewName": "sap.m.sample.Button.Page"
+      }
+    };
+    const rejectButton = await browser.uiControl(rejectButtonProperties);
+
+    await expect(rejectButton).toBeDisplayedInViewport();
+    await expect(rejectButton).toBeClickable();
+
+    // Use nested ancestorProperties
+    const rejectButtonWithNestedAncestorProperties = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.m.Button",
+        "text": "Reject",
+        "ancestorProperties": {
+          "metadata": "sap.m.FlexItemData",
+          "viewName": "sap.m.sample.Button.Page"
+        }
+      }
+    };
+
+    const sameRejectButton = await browser.uiControl(
+      rejectButtonWithNestedAncestorProperties
+    );
+
+    await expect(sameRejectButton).toBeDisplayedInViewport();
+    await expect(sameRejectButton).toBeClickable();
+
+    // Compare property id to check that it is the same element
+    const rejectButtonId = await rejectButton.getProperty("id");
+    await expect(sameRejectButton.getProperty("id")).resolves.toEqual(rejectButtonId);
+  });
+
+  it("should access element(s) by ancestor properties and index", async function () {
+    await browser.navigateTo("https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.Button/sample/sap.m.sample.Button");
+    await handleCookiesConsent();
+
+    const defaultButtonsProperties = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.m.Button",
+        "text": "Default"
+      },
+      "ancestorProperties": {
+        "metadata": "sap.m.Toolbar",
+        "viewName": "sap.m.sample.Button.Page"
+      }
+    };
+
+    const buttons = await browser.uiControls(defaultButtonsProperties);
+    expect(buttons.length).toBeGreaterThanOrEqual(2);
+
+    const firstButtonWithoutIndex = await browser.uiControl(defaultButtonsProperties);
+    const firstButton = await browser.uiControl(defaultButtonsProperties, 0);
+    const firstButtonId = await firstButton.getProperty("id");
+
+    // Compare Ids to check that these elements are the same element (with 0-index and without index)
+    await expect(firstButtonWithoutIndex.getProperty("id")).resolves.toEqual(firstButtonId);
+
+    const secondButton = await browser.uiControl(defaultButtonsProperties, 1);
+
+    // Compare Ids to check that these are two different buttons
+    await expect(secondButton.getProperty("id")).resolves.not.toEqual(firstButtonId);
+  });
+
+  it("should try access element only by ancestor properties and fail (unhappy case)", async function () {
+    await browser.navigateTo(
+      "https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.Button/sample/sap.m.sample.Button");
+    await handleCookiesConsent();
+
+    const wrongSelectorWithoutElementProperties = {
+      "ancestorProperties": {
+        "metadata": "sap.tnt.NavigationList",
+        "viewName": "sap.tnt.sample.SideNavigation.V",
+        "selectedKey": "subItem_non"
+      }
+    };
+    await expect(browser.uiControl(wrongSelectorWithoutElementProperties))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+});

package/test/core/functional/locators/childProperties.test.js

@@ -0,0 +1,40 @@
+"use strict";
+const { handleCookiesConsent } = require("../../../helper/utils");
+
+describe("webdriver.io page locator test", function () {
+
+  this.beforeAll(async () => {
+    await browser.navigateTo("https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.Button/sample/sap.m.sample.Button");
+    await handleCookiesConsent();
+  });
+
+  it("should access element by elementProperties, childProperties and inner childProperties", async function () {
+    const backButtonProperties = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.m.Button",
+        "type": "Back"
+      },
+      "childProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.ui.core.Icon",
+        "src": "sap-icon://nav-back"
+      }
+    };
+    const backButton = await browser.uiControl(backButtonProperties);
+    await expect(backButton).toBeDisplayed();
+    await expect(backButton).toBeClickable();
+  });
+
+  it("should access element only by child properties and fail (unhappy case)", async function () {
+    const wrongSelectorWithoutElementProperties = {
+      "childProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.ui.core.Icon",
+        "src": "sap-icon://nav-back"
+      }
+    };
+    await expect(browser.uiControl(wrongSelectorWithoutElementProperties))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+});

package/test/core/functional/locators/descendantProperties.test.js

@@ -0,0 +1,107 @@
+"use strict";
+const { handleCookiesConsent } = require("../../../helper/utils");
+
+describe("webdriver.io page locator test", function () {
+
+  it("should access element by elementProperties, descendantProperties and inner descendantProperties", async function () {
+    await browser.navigateTo("https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.Button/sample/sap.m.sample.Button");
+    await handleCookiesConsent();
+
+    const backButtonProperties = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.m.Button",
+        "type": "Back"
+      },
+      "descendantProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.ui.core.Icon",
+        "src": "sap-icon://nav-back"
+      }
+    };
+
+    const backButton = await browser.uiControl(backButtonProperties);
+    await expect(backButton).toBeDisplayed();
+    await expect(backButton).toBeClickable();
+
+    // Use nested ancestorProperties
+    const backButtonWithNestedDescendantProperties = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.m.Button",
+        "type": "Back",
+        "descendantProperties": {
+          "viewName": "sap.m.sample.Button.Page",
+          "metadata": "sap.ui.core.Icon",
+          "src": "sap-icon://nav-back"
+        }
+      }
+    };
+
+    const sameBackButton = await browser.uiControl(backButtonWithNestedDescendantProperties);
+    await expect(sameBackButton).toBeDisplayed();
+    await expect(sameBackButton).toBeClickable();
+
+    // Compare IDs to be sure that both elements are the same reject button;
+    const backButtonId = await backButton.getProperty("id");
+    const sameBackButtonId = await sameBackButton.getProperty("id");
+
+    expect(backButtonId).toEqual(sameBackButtonId);
+  });
+
+  it("should access element(s) by descendantProperties", async function () {
+    await browser.url("#/categories");
+    const ui5ControlProperties = {
+      "descendantProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.List",
+        "id": "*categoryList"
+      }
+    };
+
+    // Code before fixes:
+    // const elems = await browser.uiControls(ui5ControlProperties);
+    // expect(elems).toBeInstanceOf(Array);
+    // expect(elems).toBeElementsArrayOfSize({ gte: 1 });
+
+    // Code after fixes:
+    await expect(browser.uiControls(ui5ControlProperties, 1, 1000))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+
+  it("should access element by element properties and descendant properties", async function () {
+    await browser.navigateTo("https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.Button/sample/sap.m.sample.Button");
+    await handleCookiesConsent();
+
+    const ui5ControlProperties = {
+      "elementProperties": {
+        "metadata": "sap.m.FlexItemData",
+        "viewName": "sap.m.sample.Button.Page"
+      },
+      "descendantProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.m.Button",
+        "text": "Default"
+      }
+    };
+    const elem = await browser.uiControl(ui5ControlProperties);
+
+    await expect(elem).toBeDisplayedInViewport();
+    expect(elem).toBeInstanceOf(Object);
+    expect(elem).toHaveAttribute("elementId");
+  });
+
+  it("try access element by wrong descendant properties and catch error", async function () {
+    await browser.url("#/categories");
+    const wrongProperties = {
+      "descendantProperties": {
+        "viewName": "sapcart.view.App",
+        "metadata": "sap.ui.core.mvc.XMLView",
+        "displayBlock": "true"
+      }
+    };
+    await expect(browser.uiControl(wrongProperties, 1, 1000))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+
+});

package/test/core/functional/locators/domProperties.test.js

@@ -0,0 +1,60 @@
+/* eslint-disable no-unused-expressions */
+describe("webdriver.io page locator test", function () {
+
+  this.beforeAll(async () => {
+    await browser.url("#/categories");
+  });
+
+  it("should access element by elementProperties and inner domProperties", async function () {
+    const ui5ControlDomProperties = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.StandardListItem",
+        "bindingContextPath": "/ProductCategories*'AC')"
+      },
+      "domProperties": {
+        "nodeName": "li",
+        "class": "sapMLIB sapMLIB-CTX sapMLIBShowSeparator sapMLIBTypeActive sapMLIBActionable sapMLIBFocusable sapMSLI sapMLIBHoverable",
+        "id": "__item1-container-cart---homeView--categoryList-0",
+        "title": "Open category Accessories"
+      }
+    };
+
+    const elem = await browser.uiControl(ui5ControlDomProperties);
+    await expect(elem).toBeDisplayed();
+    await expect(elem).toBeClickable();
+  });
+
+  it("should access element only by domProperties (unhappy case)", async function () {
+    const selectorWithoutElementProperties = {
+      "domProperties": {
+        "nodeName": "li",
+        "class": "sapMLIB sapMLIB-CTX sapMLIBShowSeparator sapMLIBTypeActive sapMLIBActionable sapMLIBFocusable sapMSLI sapMLIBHoverable",
+        "id": "__item1-container-cart---homeView--categoryList-0",
+        "title": "Open category Accessories"
+      }
+    };
+
+    await expect(browser.uiControl(selectorWithoutElementProperties))
+      .rejects.toThrow(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+
+  it("try access element by element properties, wrong dom properties and catch error", async function () {
+    const wrongProperties = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.StandardListItem",
+        "bindingContextPath": "/ProductCategories*'AC')",
+        "domProperties": {
+          "nodeName": "div",
+          "class": "sapMLIB sapMLIB-CTX sapMLIBShowSeparator sapMLIBTypeActive sapMLIBActionable sapMLIBFocusable sapMSLI sapMLIBHoverable",
+          "id": "__item1-container-cart---homeView--categoryList-0",
+          "title": "Open category Accessories"
+        }
+      }
+    };
+    await expect(browser.uiControl(wrongProperties))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+
+});

package/test/core/functional/locators/elementProperties.test.js

@@ -0,0 +1,114 @@
+/* eslint-disable no-unused-expressions */
+const { checkIfAnElementIsUnique } = require("./utils");
+
+describe("webdriver.io access to element via elementProperties test", function () {
+  this.beforeAll(async () => {
+    await browser.url("#/categories");
+  });
+
+  it("should access element by id", async function () {
+    const categoryListElementProperties = {
+      "elementProperties": {
+        "id": "*categoryList-0"
+      }
+    };
+    const categoryListElement = await browser.uiControl(categoryListElementProperties, 0, 60000);
+    const categoryListElements = await browser.uiControls(categoryListElementProperties, 60000);
+
+    expect(categoryListElements.length).toBe(1);
+    await expect(categoryListElement).toBeDisplayedInViewport();
+    await expect(categoryListElement).toBeClickable();
+
+    await expect(categoryListElements[0]).toBeDisplayedInViewport();
+    await expect(categoryListElements[0]).toBeClickable();
+
+    checkIfAnElementIsUnique(categoryListElement, categoryListElements);
+
+    // Text include count of products too, so we need to use Match
+    await expect(categoryListElement.getText()).resolves.toMatch(/Accessories/);
+  });
+
+  it("should access element by binding context", async function () {
+    const ui5ControlProperties = {
+      "elementProperties": {
+        "bindingContextPath": "/ProductCategories('AC')"
+      }
+    };
+    const categoryListElement = await browser.uiControl(ui5ControlProperties, 0, 60000);
+    const categoryListElements = await browser.uiControls(ui5ControlProperties, 60000);
+
+    expect(categoryListElements.length).toBe(1);
+    await expect(categoryListElement).toBeDisplayedInViewport();
+    await expect(categoryListElement).toBeClickable();
+
+    checkIfAnElementIsUnique(categoryListElement, categoryListElements);
+
+    // Text include count of products too, so we need to use Match
+    await expect(categoryListElement.getText()).resolves.toMatch(/Accessories/);
+  });
+
+  it("should access element by viewName, metadata, bindingContextPath, text->path and fail to click non-clickable element", async function () {
+    const ui5ControlProperties = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.StandardListItem",
+        "bindingContextPath": "/ProductCategories*'DC')"
+      }
+    };
+    const element = await browser.uiControl(ui5ControlProperties, 0, 60000);
+    await expect(element.getText()).resolves.toMatch(/Desktop Computers/);
+
+    // Navigate to products to have access to a Product 'Compare' link
+    await element.click();
+
+    const compareLinkProperties = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Category",
+        "metadata": "sap.m.ObjectAttribute",
+        "bindingContextPath": "/Products*'HT-1600')",
+        "text": [{
+          "path": "i18n>CompareWith"
+        }]
+      }
+    };
+    const link = await browser.uiControl(compareLinkProperties, 0, 60000);
+    const links = await browser.uiControls(compareLinkProperties, 60000);
+    await expect(link.getText()).resolves.toEqual("Compare");
+    await expect(link).toBeDisplayedInViewport();
+    await expect(link).not.toBeClickable();
+
+    checkIfAnElementIsUnique(link, links);
+
+    await expect(link.click()).rejects.toThrowError(/is not clickable at point/);
+
+    // Check that without text->path cannot get unique element: without 'text->path' we can access to a link and a Product (2 elements)
+    const productLinksProperties = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Category",
+        "metadata": "sap.m.ObjectAttribute",
+        "bindingContextPath": "/Products*'HT-1600')"
+      }
+    };
+
+    const productLinks = await browser.uiControls(productLinksProperties, 60000);
+    expect(productLinks.length).toBeGreaterThanOrEqual(2);
+  });
+
+  it("should fail because element is not available: timeout error", async function () {
+    // Try to access 'Add to Cart' button, which is not available at the screen
+    const nonAvailableButtonProperties = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Product",
+        "metadata": "sap.m.Button",
+        "text": [{
+          "path": "i18n>addToCartShort"
+        }]
+      }
+    };
+
+    await expect(browser.uiControl(nonAvailableButtonProperties, 0, 60000))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+});
+
+

package/test/core/functional/locators/mixedProperties.test.js

@@ -0,0 +1,170 @@
+describe("Test for mixed properties (elementProperties, ancestorProperties, siblingProperties and descendantProperties)", function () {
+  this.beforeAll(async () => {
+    await browser.url("#/categories");
+  });
+
+  it("'happy case': should access element by nested elementProperties, ancestorProperties, siblingProperties, descendantProperties and domProperties", async () => {
+    const selector = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.Bar",
+        "id": "*page-intHeader",
+        "siblingProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Toolbar",
+          "id": "*searchBar33343",
+          "domProperties": {
+            "nodeName": "div",
+            "class": "sapMIBar sapMTB sapMTBNewFlex sapMTBInactive sapMTBStandard sapMTB-Auto-CTX sapMIBar-CTX sapMSubHeader-CTX sapContrastPlus",
+            "id": "container-cart---homeView--searchBar33343"
+          }
+        },
+        "ancestorProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Page",
+          "id": "*page",
+          "ancestorProperties": {
+            "viewName": "sap.ui.demo.cart.view.Home",
+            "metadata": "sap.ui.core.mvc.XMLView",
+            "descendantProperties": {
+              "viewName": "sap.ui.demo.cart.view.Home",
+              "metadata": "sap.m.Page",
+              "id": "*page"
+            }
+          }
+        }
+      }
+    };
+
+    await expect(browser.uiControl(selector)).toBeClickable();
+  });
+
+  it("'unhappy case': should access element by nested elementProperties, ancestorProperties, siblingProperties, domProperties and wrong descendantProperties", async () => {
+    const selector = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.Bar",
+        "id": "*page-intHeader",
+        "siblingProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Toolbar",
+          "id": "*searchBar33343",
+          "domProperties": {
+            "nodeName": "div",
+            "class": "sapMIBar sapMTB sapMTBNewFlex sapMTBInactive sapMTBStandard sapMTB-Auto-CTX sapMIBar-CTX sapMSubHeader-CTX sapContrastPlus",
+            "id": "container-cart---homeView--searchBar33343"
+          }
+        },
+        "ancestorProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Page",
+          "id": "*page",
+          "ancestorProperties": {
+            "viewName": "sap.ui.demo.cart.view.Home",
+            "metadata": "sap.m.Page", // "sap.m.Page" instead of  "sap.ui.core.mvc.XMLView"
+            "descendantProperties": {
+              "viewName": "sap.ui.demo.cart.view.Home",
+              "metadata": "sap.m.Page",
+              "id": "*page"
+            }
+          }
+        }
+      }
+    };
+
+    await expect(browser.uiControl(selector))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+
+  it("'happy case': should access element by nested elementProperties, ancestorProperties, empty siblingProperties and descendantProperties", async () => {
+    const selector = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.Bar",
+        "id": "*page-intHeader",
+        "siblingProperties": "", // empty siblingProperties
+        "ancestorProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Page",
+          "id": "*page",
+          "ancestorProperties": {
+            "viewName": "sap.ui.demo.cart.view.Home",
+            "metadata": "sap.ui.core.mvc.XMLView",
+            "descendantProperties": {
+              "viewName": "sap.ui.demo.cart.view.Home",
+              "metadata": "sap.m.Page",
+              "id": "*page"
+            }
+          }
+        }
+      }
+    };
+    await expect(browser.uiControl(selector)).toBeTruthy();
+  });
+
+  it("'happy case': should access element by nested elementProperties, ancestorProperties, domProperties, siblingProperties and empty descendantProperties", async () => {
+    const selector = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.Bar",
+        "id": "*page-intHeader",
+        "siblingProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Toolbar",
+          "id": "*searchBar33343",
+          "domProperties": {
+            "nodeName": "div",
+            "class": "sapMIBar sapMTB sapMTBNewFlex sapMTBInactive sapMTBStandard sapMTB-Auto-CTX sapMIBar-CTX sapMSubHeader-CTX sapContrastPlus",
+            "id": "container-cart---homeView--searchBar33343"
+          }
+        },
+        "ancestorProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Page",
+          "id": "*page",
+          "ancestorProperties": {
+            "viewName": "sap.ui.demo.cart.view.Home",
+            "metadata": "sap.ui.core.mvc.XMLView",
+            "descendantProperties": ""
+          }
+        }
+      }
+    };
+    await expect(browser.uiControl(selector)).toBeTruthy();
+  });
+
+  it("'unhappy case': should access element by nested elementProperties, ancestorProperties, siblingProperties, descendantProperties and wrong domProperties", async () => {
+    const selector = {
+      "elementProperties": {
+        "viewName": "sap.ui.demo.cart.view.Home",
+        "metadata": "sap.m.Bar",
+        "id": "*page-intHeader",
+        "siblingProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Toolbar",
+          "id": "*searchBar33343",
+          "domProperties": {
+            "nodeName": "li", // nodeName "li" instead of "div"
+            "id": "container-cart---homeView--searchBar33343"
+          }
+        },
+        "ancestorProperties": {
+          "viewName": "sap.ui.demo.cart.view.Home",
+          "metadata": "sap.m.Page",
+          "id": "*page",
+          "ancestorProperties": {
+            "viewName": "sap.ui.demo.cart.view.Home",
+            "metadata": "sap.ui.core.mvc.XMLView",
+            "descendantProperties": {
+              "viewName": "sap.ui.demo.cart.view.Home",
+              "metadata": "sap.m.Page",
+              "id": "*page"
+            }
+          }
+        }
+      }
+    };
+    await expect(browser.uiControl(selector))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+});

package/test/core/functional/locators/parentProperties.test.js

@@ -0,0 +1,47 @@
+"use strict";
+const { handleCookiesConsent } = require("../../../helper/utils");
+
+describe("webdriver.io page locator test", function () {
+  it("should access element by elementProperties, parentProperties and inner parentProperties", async function () {
+    await browser.navigateTo(
+      "https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.Button/sample/sap.m.sample.Button"
+    );
+    await handleCookiesConsent();
+
+    const backButtonProperties = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.ui.core.Icon",
+        "src": "sap-icon://nav-back"
+      },
+      "parentProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.m.Button",
+        "type": "Back"
+      }
+    };
+
+    const backButton = await browser.uiControl(backButtonProperties);
+    await expect(backButton).toBeDisplayed();
+    await expect(backButton).toBeClickable();
+  });
+
+
+  it("try access element by elementProperties and wrong parent properties and catch error", async function () {
+    await browser.url("#/categories");
+    const wrongProperties = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "sap.ui.core.Icon",
+        "src": "sap-icon://nav-back"
+      },
+      "parentProperties": {
+        "viewName": "sap.m.sample.Button.Page",
+        "metadata": "m.Button",
+        "type": "Back"
+      }
+    };
+    await expect(browser.uiControl(wrongProperties))
+      .rejects.toThrowError(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+});