@sap_oss/wdio-qmate-service 2.2.0 → 2.3.0

package/docs/doc.md

@@ -390,7 +390,7 @@ Fills the active input with the given value.
 
 | Param | Type | Description |
 | --- | --- | --- |
-| value | <code>String</code> | The value with witch the input should be filled. |
+| value | <code>String</code> \| <code>Number</code> | The value to enter. |
 
 **Example**  
 ```js
@@ -405,7 +405,7 @@ Enters the given value to the active input field and retries the action in case
 
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
-| value | <code>String</code> |  | The value with witch the input should be filled. |
+| value | <code>String</code> |  | The value to enter. |
 | [retries] | <code>Number</code> | <code>3</code> | The number of retries, can be set in config for all functions under params stepsRetries. |
 | [interval] | <code>Number</code> | <code>5000</code> | The delay between the retries (ms). Can be set in config for all functions under params.stepRetriesIntervals. |
 
@@ -1598,8 +1598,9 @@ Global namespace for UI5 modules.
         * [.doubleClick(selector, [index], [timeout])](#ui5.userInteraction.doubleClick)
         * [.rightClick(selector, [index], [timeout])](#ui5.userInteraction.rightClick)
         * [.clickTab(selector, [index], [timeout])](#ui5.userInteraction.clickTab)
-        * [.selectFromTab(selector, value, [index], [timeout])](#ui5.userInteraction.selectFromTab)
         * [.clickListItem(selector, [index], [timeout])](#ui5.userInteraction.clickListItem)
+        * [.check(selector, [index], [timeout])](#ui5.userInteraction.check)
+        * [.uncheck(selector, [index], [timeout])](#ui5.userInteraction.uncheck)
         * [.fill(selector, value, [index], [timeout])](#ui5.userInteraction.fill)
         * [.fillAndRetry(selector, value, [index], [timeout], [retries], [interval])](#ui5.userInteraction.fillAndRetry)
         * [.clear(selector, [index], [timeout])](#ui5.userInteraction.clear)
@@ -1614,6 +1615,7 @@ Global namespace for UI5 modules.
         * [.selectMultiComboBox(selector, values, [index])](#ui5.userInteraction.selectMultiComboBox)
         * [.clickSelectArrow(selector, [index])](#ui5.userInteraction.clickSelectArrow)
         * [.clickSelectArrowAndRetry(selector, [index], [retries], [interval])](#ui5.userInteraction.clickSelectArrowAndRetry)
+        * [.selectFromTab(selector, value, [index], [timeout])](#ui5.userInteraction.selectFromTab)
         * [.mouseOverElement(selector, [index], [timeout])](#ui5.userInteraction.mouseOverElement)
         * [.scrollToElement(selector, [index], [alignment], [timeout])](#ui5.userInteraction.scrollToElement)
         * [.selectAll([selector], [index], [timeout])](#ui5.userInteraction.selectAll)
@@ -3495,8 +3497,9 @@ await ui5.table.clickSettingsButton(glAccountItemsTable);
     * [.doubleClick(selector, [index], [timeout])](#ui5.userInteraction.doubleClick)
     * [.rightClick(selector, [index], [timeout])](#ui5.userInteraction.rightClick)
     * [.clickTab(selector, [index], [timeout])](#ui5.userInteraction.clickTab)
-    * [.selectFromTab(selector, value, [index], [timeout])](#ui5.userInteraction.selectFromTab)
     * [.clickListItem(selector, [index], [timeout])](#ui5.userInteraction.clickListItem)
+    * [.check(selector, [index], [timeout])](#ui5.userInteraction.check)
+    * [.uncheck(selector, [index], [timeout])](#ui5.userInteraction.uncheck)
     * [.fill(selector, value, [index], [timeout])](#ui5.userInteraction.fill)
     * [.fillAndRetry(selector, value, [index], [timeout], [retries], [interval])](#ui5.userInteraction.fillAndRetry)
     * [.clear(selector, [index], [timeout])](#ui5.userInteraction.clear)
@@ -3511,6 +3514,7 @@ await ui5.table.clickSettingsButton(glAccountItemsTable);
     * [.selectMultiComboBox(selector, values, [index])](#ui5.userInteraction.selectMultiComboBox)
     * [.clickSelectArrow(selector, [index])](#ui5.userInteraction.clickSelectArrow)
     * [.clickSelectArrowAndRetry(selector, [index], [retries], [interval])](#ui5.userInteraction.clickSelectArrowAndRetry)
+    * [.selectFromTab(selector, value, [index], [timeout])](#ui5.userInteraction.selectFromTab)
     * [.mouseOverElement(selector, [index], [timeout])](#ui5.userInteraction.mouseOverElement)
     * [.scrollToElement(selector, [index], [alignment], [timeout])](#ui5.userInteraction.scrollToElement)
     * [.selectAll([selector], [index], [timeout])](#ui5.userInteraction.selectAll)
@@ -3607,31 +3611,29 @@ The function retries the click for maximal 3 times if the selection of the tab (
 ```js
 await ui5.userInteraction.clickTab(selector);
 ```
-<a name="ui5.userInteraction.selectFromTab"></a>
+<a name="ui5.userInteraction.clickListItem"></a>
 
-#### userInteraction.selectFromTab(selector, value, [index], [timeout])
-Selects the passed value on the tab with the given selector and checks if the tab got selected successfully.
-The function retries the click for maximal 3 times if the selection of the tab (blue underline) was not successful.
+#### userInteraction.clickListItem(selector, [index], [timeout])
+Clicks or opens the list item with the given selector (e.g. ColumnListItem, StandardListItem).
+In some cases the default click function is not working correctly (clicks an element within the list item).
+Therefore we recommend to use this function to open a specific list item.
 
 **Kind**: static method of [<code>userInteraction</code>](#ui5.userInteraction)  
 
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | selector | <code>Object</code> |  | The selector describing the element. |
-| value | <code>String</code> |  | The value to select. |
 | [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
 | [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
 
 **Example**  
 ```js
-await ui5.userInteraction.selectFromTab(selector);
+await ui5.userInteraction.clickListItem(selector);
 ```
-<a name="ui5.userInteraction.clickListItem"></a>
+<a name="ui5.userInteraction.check"></a>
 
-#### userInteraction.clickListItem(selector, [index], [timeout])
-Clicks or opens the list item with the given selector (e.g. ColumnListItem, StandardListItem).
-In some cases the default click function is not working correctly (clicks an element within the list item).
-Therefore we recommend to use this function to open a specific list item.
+#### userInteraction.check(selector, [index], [timeout])
+Checks the checkbox with the given selector.
 
 **Kind**: static method of [<code>userInteraction</code>](#ui5.userInteraction)  
 
@@ -3643,7 +3645,24 @@ Therefore we recommend to use this function to open a specific list item.
 
 **Example**  
 ```js
-await ui5.userInteraction.clickListItem(selector);
+await ui5.userInteraction.check(selector);
+```
+<a name="ui5.userInteraction.uncheck"></a>
+
+#### userInteraction.uncheck(selector, [index], [timeout])
+Unchecks the checkbox with the given selector.
+
+**Kind**: static method of [<code>userInteraction</code>](#ui5.userInteraction)  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| selector | <code>Object</code> |  | The selector describing the element. |
+| [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
+| [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
+
+**Example**  
+```js
+await ui5.userInteraction.uncheck(selector);
 ```
 <a name="ui5.userInteraction.fill"></a>
 
@@ -3655,7 +3674,7 @@ Fills the input field with the given selector.
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | selector | <code>Object</code> |  | The selector describing the element. |
-| value | <code>String</code> |  | The value to fill. |
+| value | <code>String</code> \| <code>Number</code> |  | The value to enter. |
 | [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
 | [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
 
@@ -3673,7 +3692,7 @@ Fills the input field with the given selector and retries the action in case of
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | selector | <code>Object</code> |  | The selector describing the element. |
-| value | <code>String</code> |  | The value to fill. |
+| value | <code>String</code> \| <code>Number</code> |  | The value to enter. |
 | [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
 | [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
 | [retries] | <code>Number</code> | <code>3</code> | The number of retries, can be set in config for all functions under params stepsRetries. |
@@ -3729,7 +3748,7 @@ Clears the input field with the given selector and fills the given value.
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | selector | <code>Object</code> |  | The selector describing the element. |
-| value | <code>String</code> |  | The value to fill. |
+| value | <code>String</code> \| <code>Number</code> |  | The value to enter. |
 | [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
 | [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
 
@@ -3747,7 +3766,7 @@ Clears the input field with the given selector and fills the given value. Retrie
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | selector | <code>Object</code> |  | The selector describing the element. |
-| value | <code>String</code> |  | The value to fill. |
+| value | <code>String</code> |  | The value to enter. |
 | [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
 | [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
 | [retries] | <code>Number</code> | <code>3</code> | The number of retries, can be set in config for all functions under params stepsRetries. |
@@ -3785,7 +3804,7 @@ Clears the smart filed with the given selector and fills the given value.
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | selector | <code>Object</code> |  | The selector describing the element. |
-| value | <code>String</code> |  | The value to fill. |
+| value | <code>String</code> |  | The value to enter. |
 | [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
 | [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
 
@@ -3803,7 +3822,7 @@ Clears the smart filed with the given selector and fills the given value and ret
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | selector | <code>Object</code> |  | The selector describing the element. |
-| value | <code>String</code> |  | The value to fill. |
+| value | <code>String</code> |  | The value to enter. |
 | [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
 | [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
 | [retries] | <code>Number</code> | <code>3</code> | The number of retries, can be set in config for all functions under params stepsRetries. |
@@ -3904,6 +3923,25 @@ Clicks the arrow icon at the passed selector (select box), and retries in case i
 ```js
 await ui5.userInteraction.clickSelectArrowAndRetry(selector);
 ```
+<a name="ui5.userInteraction.selectFromTab"></a>
+
+#### userInteraction.selectFromTab(selector, value, [index], [timeout])
+Selects the passed value on the tab with the given selector and checks if the tab got selected successfully.
+The function retries the click for maximal 3 times if the selection of the tab (blue underline) was not successful.
+
+**Kind**: static method of [<code>userInteraction</code>](#ui5.userInteraction)  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| selector | <code>Object</code> |  | The selector describing the element. |
+| value | <code>String</code> |  | The value to select. |
+| [index] | <code>Number</code> | <code>0</code> | The index of the selector (in case there are more than one elements visible at the same time). |
+| [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
+
+**Example**  
+```js
+await ui5.userInteraction.selectFromTab(selector);
+```
 <a name="ui5.userInteraction.mouseOverElement"></a>
 
 #### userInteraction.mouseOverElement(selector, [index], [timeout])
@@ -4047,6 +4085,7 @@ Global namespace for non UI5 modules.
         * [.isPresent(elem)](#nonUi5.element.isPresent) ⇒ <code>Boolean</code>
         * [.isPresentByCss(css, [index], [timeout])](#nonUi5.element.isPresentByCss) ⇒ <code>boolean</code>
         * [.isPresentByXPath(xpath, [index], [timeout])](#nonUi5.element.isPresentByXPath) ⇒ <code>boolean</code>
+        * [.isSelected(elem)](#nonUi5.element.isSelected) ⇒ <code>boolean</code>
         * [.getAttributeValue(elem, [attribute])](#nonUi5.element.getAttributeValue) ⇒ <code>String</code>
         * [.getValue(elem)](#nonUi5.element.getValue) ⇒ <code>String</code>
         * [.setInnerHTML(elem)](#nonUi5.element.setInnerHTML) ⇒ <code>String</code>
@@ -4062,6 +4101,8 @@ Global namespace for non UI5 modules.
         * [.clickAndRetry(element, [timeout], [retries], [interval])](#nonUi5.userInteraction.clickAndRetry)
         * [.doubleClick(element, [timeout])](#nonUi5.userInteraction.doubleClick)
         * [.rightClick(element, [timeout])](#nonUi5.userInteraction.rightClick)
+        * [.check(element)](#nonUi5.userInteraction.check)
+        * [.uncheck(element)](#nonUi5.userInteraction.uncheck)
         * [.fill(element, value)](#nonUi5.userInteraction.fill)
         * [.fillAndRetry(element, value, [retries], [interval])](#nonUi5.userInteraction.fillAndRetry)
         * [.clear(element)](#nonUi5.userInteraction.clear)
@@ -4201,6 +4242,7 @@ await nonUi5.assertion.expectToBeNotVisible(elem, 5000);
     * [.isPresent(elem)](#nonUi5.element.isPresent) ⇒ <code>Boolean</code>
     * [.isPresentByCss(css, [index], [timeout])](#nonUi5.element.isPresentByCss) ⇒ <code>boolean</code>
     * [.isPresentByXPath(xpath, [index], [timeout])](#nonUi5.element.isPresentByXPath) ⇒ <code>boolean</code>
+    * [.isSelected(elem)](#nonUi5.element.isSelected) ⇒ <code>boolean</code>
     * [.getAttributeValue(elem, [attribute])](#nonUi5.element.getAttributeValue) ⇒ <code>String</code>
     * [.getValue(elem)](#nonUi5.element.getValue) ⇒ <code>String</code>
     * [.setInnerHTML(elem)](#nonUi5.element.setInnerHTML) ⇒ <code>String</code>
@@ -4543,7 +4585,7 @@ await nonUi5.element.isPresentByCss(".button01");
 <a name="nonUi5.element.isPresentByXPath"></a>
 
 #### element.isPresentByXPath(xpath, [index], [timeout]) ⇒ <code>boolean</code>
-returns a boolean if the element is present at the DOM or not.
+Returns a boolean if the element is present at the DOM or not.
 
 **Kind**: static method of [<code>element</code>](#nonUi5.element)  
 
@@ -4557,6 +4599,22 @@ returns a boolean if the element is present at the DOM or not.
 ```js
 await nonUi5.element.isPresentByXPath(".//*[text()='Create']");
 ```
+<a name="nonUi5.element.isSelected"></a>
+
+#### element.isSelected(elem) ⇒ <code>boolean</code>
+Returns a boolean if the element (e.g. checkbox) is selected.
+
+**Kind**: static method of [<code>element</code>](#nonUi5.element)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| elem | <code>Object</code> | The element. |
+
+**Example**  
+```js
+const elem = await nonUi5.element.getById("elem01");
+const isSelected = await nonUi5.element.isSelected(elem);
+```
 <a name="nonUi5.element.getAttributeValue"></a>
 
 #### element.getAttributeValue(elem, [attribute]) ⇒ <code>String</code>
@@ -4721,6 +4779,8 @@ await nonUi5.session.loginSapNetWeaver("john", "abc123!");
     * [.clickAndRetry(element, [timeout], [retries], [interval])](#nonUi5.userInteraction.clickAndRetry)
     * [.doubleClick(element, [timeout])](#nonUi5.userInteraction.doubleClick)
     * [.rightClick(element, [timeout])](#nonUi5.userInteraction.rightClick)
+    * [.check(element)](#nonUi5.userInteraction.check)
+    * [.uncheck(element)](#nonUi5.userInteraction.uncheck)
     * [.fill(element, value)](#nonUi5.userInteraction.fill)
     * [.fillAndRetry(element, value, [retries], [interval])](#nonUi5.userInteraction.fillAndRetry)
     * [.clear(element)](#nonUi5.userInteraction.clear)
@@ -4803,6 +4863,36 @@ Right Clicks on the passed element.
 const elem = await nonUi5.element.getById("button01");
 await nonUi5.userInteraction.rightClick(elem);
 ```
+<a name="nonUi5.userInteraction.check"></a>
+
+#### userInteraction.check(element)
+Checks the given checkbox.
+
+**Kind**: static method of [<code>userInteraction</code>](#nonUi5.userInteraction)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| element | <code>Object</code> | The element. |
+
+**Example**  
+```js
+await nonUi5.userInteraction.check(selector);
+```
+<a name="nonUi5.userInteraction.uncheck"></a>
+
+#### userInteraction.uncheck(element)
+Unchecks the given checkbox.
+
+**Kind**: static method of [<code>userInteraction</code>](#nonUi5.userInteraction)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| element | <code>Object</code> | The element. |
+
+**Example**  
+```js
+await nonUi5.userInteraction.uncheck(selector);
+```
 <a name="nonUi5.userInteraction.fill"></a>
 
 #### userInteraction.fill(element, value)
@@ -4813,7 +4903,7 @@ Fills the given value into the passed input.
 | Param | Type | Description |
 | --- | --- | --- |
 | element | <code>Object</code> | The element. |
-| value | <code>String</code> | The value to be filled. |
+| value | <code>String</code> \| <code>Number</code> | The value to enter. |
 
 **Example**  
 ```js
@@ -4830,7 +4920,7 @@ Fills the given value into the passed input, retries in case of a failure.
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | element | <code>Object</code> |  | The element. |
-| value | <code>String</code> |  | The value to be filled. |
+| value | <code>String</code> \| <code>Number</code> |  | The value to enter. |
 | [retries] | <code>Number</code> | <code>3</code> | The number of retries, can be set in config for all functions under params stepsRetries. |
 | [interval] | <code>Number</code> | <code>5000</code> | The delay between the retries (ms). Can be set in config for all functions under params.stepRetriesIntervals. |
 
@@ -4883,7 +4973,7 @@ Clears and fills the passed input element.
 | Param | Type | Description |
 | --- | --- | --- |
 | element | <code>Object</code> | The element. |
-| value | <code>String</code> | The value to be filled in. |
+| value | <code>String</code> \| <code>Number</code> | The value to enter in. |
 
 **Example**  
 ```js
@@ -4900,7 +4990,7 @@ Clears and fills the passed input, retries in case it fails.
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | element | <code>Object</code> |  | The element. |
-| value | <code>String</code> |  | The value to be filled in. |
+| value | <code>String</code> \| <code>Number</code> |  | The value to enter in. |
 | [retries] | <code>Number</code> | <code>3</code> | The number of retries, can be set in config for all functions under params stepsRetries. |
 | [interval] | <code>Number</code> | <code>5000</code> | The delay between the retries (ms). Can be set in config for all functions under params.stepRetriesIntervals. |
 | [verify] | <code>Boolean</code> | <code>true</code> | Specifies if the filled value should be verified. |
@@ -4919,7 +5009,7 @@ Moves the cursor/focus to the passed element.
 
 | Param | Type | Description |
 | --- | --- | --- |
-| element | <code>Object</code> | The selector describing the element. |
+| element | <code>Object</code> | The element. |
 | [xOffset] | <code>Number</code> | X offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element. |
 | [yOffset] | <code>Number</code> | Y offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element. |
 

package/docs/index.md

@@ -1,9 +1,8 @@
 # **Qmate** Service
 **Qmate Service** is a custom [WebdriverIO](https://webdriver.io/) service for testing web applications and APIs.
 
-!!! warning
-    The latest version of **WebdriverIO V8** is **not** yet supported. Support will follow soon.
-
+!!! note
+    The latest release of the Qmate Service is compatible with **WebdriverIO V8**.
 ## Main features
 The main features of this service are:
 

package/lib/reuse/helper/jsonDocGen.js

@@ -105,8 +105,8 @@ function getReturnType(tags) {
 function mapTagToArgument(tag) {
     return {
         name: tag.name,
-        type: (tag.type && tag.type.name && tag.type.name.toLowerCase()) || "string",
-        default: tag.default ? tag.default : null
+        type: getArgumentType(tag),
+        default: getArgumentDefaultValue(tag)
     };
 }
 function parseReturnTypeFromReturnTag(tag) {
@@ -118,4 +118,51 @@ function parseReturnTypeFromReturnTag(tag) {
     }
     return undefined;
 }
+function getArgumentType(tag) {
+    if (cannotParseArgumentTypeFromTag(tag)) {
+        return "string";
+    }
+    if (canParseArgumentTypeFromTagName(tag)) {
+        return parseArgumentTypeFromTagName(tag);
+    }
+    else if (canParseArgumentTypeFromTagExpression(tag)) {
+        return parseArgumentTypeFromTagExpression(tag);
+    }
+}
+function getArgumentDefaultValue(tag) {
+    if (!tag.default) {
+        return null;
+    }
+    return getArgumentDefaultValueBasedOnType(tag);
+}
+function cannotParseArgumentTypeFromTag(tag) {
+    return !canParseArgumentTypeFromTag(tag);
+}
+function canParseArgumentTypeFromTag(tag) {
+    return tag.type
+        && (canParseArgumentTypeFromTagName(tag)
+            || canParseArgumentTypeFromTagExpression(tag));
+}
+function canParseArgumentTypeFromTagName(tag) {
+    return !!tag.type.name;
+}
+function parseArgumentTypeFromTagName(tag) {
+    return tag.type.name.toLowerCase();
+}
+function canParseArgumentTypeFromTagExpression(tag) {
+    return tag.type.expression && tag.type.expression.name;
+}
+function parseArgumentTypeFromTagExpression(tag) {
+    return tag.type.expression.name.toLowerCase();
+}
+function getArgumentDefaultValueBasedOnType(tag) {
+    const type = getArgumentType(tag);
+    if (type === "number") {
+        return parseInt(tag.default);
+    }
+    if (type === "boolean") {
+        return Boolean(tag.default);
+    }
+    return tag.default;
+}
 //# sourceMappingURL=jsonDocGen.js.map

package/lib/reuse/helper/jsonDocGen.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonDocGen.js","sourceRoot":"","sources":["../../../src/reuse/helper/jsonDocGen.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"jsonDocGen.js","sourceRoot":"","sources":["../../../src/reuse/helper/jsonDocGen.js"],"names":[],"mappings":"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"}

package/lib/reuse/modules/ui5/control.d.ts

@@ -23,6 +23,17 @@ export declare class Control {
      * }, selector, args);
      **/
     execute(callbackFunction: Function, selectorOrElement: Element | Ui5Selector | Ui5SelectorWithOptions, args?: any): Promise<any>;
+    /**
+     * @function focus
+     * @memberOf ui5.control
+     * @description Focuses on the element with the given selector to get it into view. If focus is not possible scrollToElement is used.
+     * @param {Object} selector - The selector describing the element.
+     * @param {Number} [index=0] - The index of the selector (in case there are more than one elements visible at the same time).
+     * @param {Number} [timeout=30000] - The timeout to wait (ms).
+     * @example await ui5.control.focus(selector);
+     * @example await ui5.control.focus(selector, 0, 5000);
+     */
+    focus(selector: any, index?: number, timeout?: string | number): Promise<void>;
     /**
      * @function getProperty
      * @memberOf ui5.control

package/lib/reuse/modules/ui5/control.js

@@ -31,6 +31,33 @@ class Control {
         const vl = this.vlf.initLog(this.execute);
         return this.lib.controlActionInBrowser(callbackFunction, selectorOrElement, args);
     }
+    /**
+     * @function focus
+     * @memberOf ui5.control
+     * @description Focuses on the element with the given selector to get it into view. If focus is not possible scrollToElement is used.
+     * @param {Object} selector - The selector describing the element.
+     * @param {Number} [index=0] - The index of the selector (in case there are more than one elements visible at the same time).
+     * @param {Number} [timeout=30000] - The timeout to wait (ms).
+     * @example await ui5.control.focus(selector);
+     * @example await ui5.control.focus(selector, 0, 5000);
+     */
+    async focus(selector, index = 0, timeout = process.env.QMATE_CUSTOM_TIMEOUT || 30000) {
+        const elem = await ui5.element.getDisplayed(selector, index, timeout);
+        const id = await elem.getAttribute("id");
+        const focused = await browser.execute(function (id) {
+            const elem = sap.ui.getCore().getElementById(id);
+            if (elem && elem.focus) {
+                elem.focus();
+                return true;
+            }
+            else {
+                return false;
+            }
+        }, id);
+        if (!focused) {
+            ui5.userInteraction.scrollToElement(selector, index, "center", timeout);
+        }
+    }
     // =================================== GET ===================================
     /**
      * @function getProperty

package/lib/reuse/modules/ui5/control.js.map

@@ -1 +1 @@
-{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../../src/reuse/modules/ui5/control.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAGb,8DAAkE;AAGlE;;;GAGG;AACH,MAAa,OAAO;IAApB;QACU,QAAG,GAAG,IAAI,oCAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAEjD,QAAG,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAAC;QAClD,oBAAe,GAAG,OAAO,CAAC,8CAA8C,CAAC,CAAC;IAqGpF,CAAC;IAnGC,kFAAkF;IAClF;;;;;;;;;;;;;QAaI;IACJ,KAAK,CAAC,OAAO,CAAC,gBAA0B,EAAE,iBAAiE,EAAE,IAAU;QACrH,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;IACpF,CAAC;IAED,8EAA8E;IAC9E;;;;;;;;;;QAUI;IACJ,KAAK,CAAC,WAAW,CAAC,iBAAiE,EAAE,YAAoB;QACvG,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;QAUI;IACJ,KAAK,CAAC,sBAAsB,CAAC,iBAAiE,EAAE,YAAoB;QAClH,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;QAUI;IACJ,KAAK,CAAC,sBAAsB,CAAC,iBAAiE,EAAE,YAAoB;QAClH,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;QAQI;IACJ,KAAK,CAAC,6BAA6B,CAAC,iBAAiE;QACnG,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,eAAe,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;QAWI;IACJ,KAAK,CAAC,kBAAkB,CAAC,iBAAiE,EAAE,YAAoB;QAC9G,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAClF,CAAC;CACF;AAzGD,0BAyGC;AACD,kBAAe,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../../src/reuse/modules/ui5/control.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sap_oss/wdio-qmate-service",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "author": "SAP SE",
   "types": "./@types/index.d.ts",
   "main": "./lib/index.js",

package/test/reuse/ui5/control/focus.spec.js

@@ -0,0 +1,100 @@
+"use strict";
+const { handleCookiesConsent } = require("../../../helper/utils");
+
+describe("control - focus - for a input field", function () {
+  it("Preparation", async function () {
+    await common.navigation.navigateToUrl("https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.ui.comp.smartfield.SmartField/sample/sap.ui.comp.sample.smartfield.TextInEditModeSource");
+    await handleCookiesConsent();
+  });
+
+  it("Execution & Verification", async function () {
+    const lastInputSelector = {
+      "elementProperties": {
+        "viewName": "sap.ui.comp.sample.smartfield.TextInEditModeSource.Main",
+        "metadata": "sap.m.Input",
+        "id": "*idValueListNoValidation-input"
+      }
+    };
+    await ui5.control.focus(lastInputSelector);
+    await ui5.userInteraction.clearAndFillAndRetry(lastInputSelector, "LN");
+  });
+});
+
+describe("control - focus", function () {
+  it("Preparation", async function () {
+    await common.navigation.navigateToUrl("https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.ActionSheet");
+    await handleCookiesConsent();
+  });
+
+  it("Execution and Verification", async function () {
+    const selector = {
+      "elementProperties": {
+        "viewName": "sap.ui.documentation.sdk.view.ControlsMaster",
+        "metadata": "sap.m.StandardListItem",
+        "bindingContextPath": "/entities/199"
+      }
+    };
+    await ui5.control.focus(selector);  //can see the scroll take place during this step
+    await ui5.assertion.expectToBeVisible(selector);
+  });
+});
+
+describe("control - focus - outside of viewpoint", function () {
+  it("Preparation", async function () {
+    await common.navigation.navigateToUrl("https://sapui5.hana.ondemand.com/1.99.0/#/entity/sap.m.MultiComboBox/sample/sap.m.sample.MultiComboBox");
+    await handleCookiesConsent();
+  });
+
+  it("Execution", async function () {
+    const selectorForDropdownList = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.MultiComboBox.view.MultiComboBox",
+        "metadata": "sap.m.MultiComboBox"
+      }
+    };
+    const selector = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.MultiComboBox.view.MultiComboBox",
+        "metadata": "sap.m.StandardListItem",
+        "title": "Smart Games"
+      }
+    };
+
+    await ui5.userInteraction.clickSelectArrow(selectorForDropdownList);
+    await ui5.control.focus(selector);
+    await ui5.userInteraction.click(selector);
+  });
+
+  it("Verification", async function () {
+    const selector = {
+      "elementProperties": {
+        "viewName": "sap.m.sample.MultiComboBox.view.MultiComboBox",
+        "metadata": "sap.m.Token"
+      }
+    };
+    await ui5.assertion.expectAttributeToBe(selector, "text", "Smart Games");
+  });
+});
+
+describe("control - focus - no selector found and catch error", function () {
+
+  it("Preparation", async function () {
+    await browser.navigateTo("https://sapui5.hana.ondemand.com/1.99.0/test-resources/sap/m/demokit/cart/webapp/index.html");
+  });
+
+  it("Execution & Verification", async function () {
+    const selector = {
+      "elementProperties": {
+        "viewName": "ghgjho.cart.view.Welcome",
+        "metadata": "",
+        "text": [{
+          "path": "i18n>promotedTitle"
+        }]
+      }
+    };
+    const index = 0;
+    const timeout = 30000;
+    await expect(ui5.control.focus(selector, index, timeout))
+      .rejects.toThrow(/uiControlExecuteLocator\(\): No visible elements found/);
+  });
+});

package/test/reuse/ui5/control/test.control.conf.js

@@ -10,6 +10,7 @@ exports.config = merge(profile.config, {
 
   specs: [
     path.resolve(__dirname, "execute.spec.js"),
+    path.resolve(__dirname, "focus.spec.js"),
     path.resolve(__dirname, "getAggregationProperty.spec.js"),
     path.resolve(__dirname, "getAssociationProperty.spec.js"),
     path.resolve(__dirname, "getBindingContextPathProperty.spec.js"),

package/test/reuse/ui5/control/test.control.sauceLab.conf.js

@@ -14,6 +14,7 @@ exports.config = merge(profile.config, {
 
   specs: [
     path.resolve(__dirname, "execute.spec.js"),
+    path.resolve(__dirname, "focus.spec.js"),
     path.resolve(__dirname, "getAggregationProperty.spec.js"),
     path.resolve(__dirname, "getAssociationProperty.spec.js"),
     path.resolve(__dirname, "getBindingContextPathProperty.spec.js"),