@sap_oss/wdio-qmate-service 1.2.3 → 1.3.0

package/docs/doc.md

@@ -567,6 +567,12 @@ Global namespace for util modules.
         * [.switchToIframe(selector)](#util.browser.switchToIframe)
         * [.switchToDefaultContent()](#util.browser.switchToDefaultContent)
         * [.back()](#util.browser.back)
+    * [.data](#util.data)
+        * [.getData(filename, [source])](#util.data.getData) ⇒ <code>Object</code>
+        * [.getSecureData(filename, [source])](#util.data.getSecureData) ⇒ <code>Object</code>
+        * [.readDataFromFile(filePath)](#util.data.readDataFromFile) ⇒ <code>Object</code>
+        * [.writeDataToFile(filePath, data)](#util.data.writeDataToFile)
+        * [.decrypt(data)](#util.data.decrypt) ⇒ <code>Object</code>
     * [.console](#util.console)
         * [.log(message, [textColor], [backgroundColor], [brightness])](#util.console.log)
         * [.error(message)](#util.console.error)
@@ -574,9 +580,11 @@ Global namespace for util modules.
         * [.success(message)](#util.console.success)
         * [.info(message)](#util.console.info)
     * [.data](#util.data)
-        * [.getData(filename)](#util.data.getData) ⇒ <code>String</code>
-        * [.getSecureData(filename)](#util.data.getSecureData) ⇒ <code>String</code>
-        * [.decrypt(data)](#util.data.decrypt) ⇒ <code>String</code>
+        * [.getData(filename, [source])](#util.data.getData) ⇒ <code>Object</code>
+        * [.getSecureData(filename, [source])](#util.data.getSecureData) ⇒ <code>Object</code>
+        * [.readDataFromFile(filePath)](#util.data.readDataFromFile) ⇒ <code>Object</code>
+        * [.writeDataToFile(filePath, data)](#util.data.writeDataToFile)
+        * [.decrypt(data)](#util.data.decrypt) ⇒ <code>Object</code>
     * [.file](#util.file)
         * [.upload(files, [selector])](#util.file.upload)
         * [.parsePdf(pdfStream, renderingMethod)](#util.file.parsePdf) ⇒ <code>String</code>
@@ -883,6 +891,100 @@ Go one step back in browser history.
 ```js
 await util.browser.back();
 ```
+<a name="util.data"></a>
+
+### util.data
+**Kind**: static class of [<code>util</code>](#util)  
+
+* [.data](#util.data)
+    * [.getData(filename, [source])](#util.data.getData) ⇒ <code>Object</code>
+    * [.getSecureData(filename, [source])](#util.data.getSecureData) ⇒ <code>Object</code>
+    * [.readDataFromFile(filePath)](#util.data.readDataFromFile) ⇒ <code>Object</code>
+    * [.writeDataToFile(filePath, data)](#util.data.writeDataToFile)
+    * [.decrypt(data)](#util.data.decrypt) ⇒ <code>Object</code>
+
+<a name="util.data.getData"></a>
+
+#### data.getData(filename, [source]) ⇒ <code>Object</code>
+Returns the data object with the given filename (JSON, stored in data folder).
+
+**Kind**: static method of [<code>data</code>](#util.data)  
+**Returns**: <code>Object</code> - The data object.  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| filename | <code>String</code> |  | The name of the data file. |
+| [source] | <code>String</code> | <code>data</code> | The source key defined under params.import of the config file. |
+
+**Example**  
+```js
+const data = util.data.getData("myTest");
+```
+<a name="util.data.getSecureData"></a>
+
+#### data.getSecureData(filename, [source]) ⇒ <code>Object</code>
+Returns and encrypts the data object with the given filename (JSON, stored in data folder). Will return the local file object if private key is not accessible.
+
+**Kind**: static method of [<code>data</code>](#util.data)  
+**Returns**: <code>Object</code> - The encrypted or local data object.  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| filename | <code>String</code> |  | The name of the data file (without suffix '.secure' or '.local'). |
+| [source] | <code>String</code> | <code>data</code> | The source key defined under params.import of the config file. |
+
+**Example**  
+```js
+const secureData = util.data.getSecureData("myTest");
+```
+<a name="util.data.readDataFromFile"></a>
+
+#### data.readDataFromFile(filePath) ⇒ <code>Object</code>
+Reads the data object from the given filepath.
+
+**Kind**: static method of [<code>data</code>](#util.data)  
+**Returns**: <code>Object</code> - The data object.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| filePath | <code>String</code> | The filepath. |
+
+**Example**  
+```js
+const data = util.data.readDataFromFile("./data/myData.json");
+```
+<a name="util.data.writeDataToFile"></a>
+
+#### data.writeDataToFile(filePath, data)
+Writes the data object to the given filepath.
+
+**Kind**: static method of [<code>data</code>](#util.data)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| filePath | <code>String</code> | The filepath. |
+| data | <code>Object</code> | The data object to write. |
+
+**Example**  
+```js
+const data = util.data.writeDataToFile("myTest");
+```
+<a name="util.data.decrypt"></a>
+
+#### data.decrypt(data) ⇒ <code>Object</code>
+Decrypts the passed input data.
+
+**Kind**: static method of [<code>data</code>](#util.data)  
+**Returns**: <code>Object</code> - The decrypted data.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| data | <code>String</code> | The encrypted data to decrypt. |
+
+**Example**  
+```js
+const decrypted = util.data.decrypt("d704004c262faa8ef4bdcf34c8a94883e15524872c7bef334d26a391a1934cf47338b749d99426980ee4cc7a81deaef21439c6894ab0324cdb29b9b6332635baca442651c5d37847f52bb90b8868e037271a7d456024b39b65fdf4dc62e8d82a3d5683a72e4324c59d339742fc79749f0ee74abef916d38e306218adc48e3547a2b346962249320c962d22cb46d9998de36d8219a2496c0997d0fc389f76fb1431a9b57c317886e9c9795c0a09ad98d9fa0b7687d10814dc7973397f3f72a227a04ead4c3d1d428c096a51922ffc4d7afc3952df1c130def5c5fb3e834605cbf1454885966cc65c77046343f4c678e74931fb2dd6cac8dae17837cf674f288d6550dd7fa6b01f5b7ea68aa6bd27d79dd5d53edb5fd4b4edce824bd31b3939352ad7a71a16bab8c54025c2bb92c54e022fcd23ff08bc54a17fc50d00dc3b884cadbfdefe1e75901fdf80e7324ad02a891f2c4863fa120ca238520b79126c65a03");
+```
 <a name="util.console"></a>
 
 ### util.console
@@ -979,21 +1081,24 @@ util.console.success("The document has been saved.");
 **Kind**: static class of [<code>util</code>](#util)  
 
 * [.data](#util.data)
-    * [.getData(filename)](#util.data.getData) ⇒ <code>String</code>
-    * [.getSecureData(filename)](#util.data.getSecureData) ⇒ <code>String</code>
-    * [.decrypt(data)](#util.data.decrypt) ⇒ <code>String</code>
+    * [.getData(filename, [source])](#util.data.getData) ⇒ <code>Object</code>
+    * [.getSecureData(filename, [source])](#util.data.getSecureData) ⇒ <code>Object</code>
+    * [.readDataFromFile(filePath)](#util.data.readDataFromFile) ⇒ <code>Object</code>
+    * [.writeDataToFile(filePath, data)](#util.data.writeDataToFile)
+    * [.decrypt(data)](#util.data.decrypt) ⇒ <code>Object</code>
 
 <a name="util.data.getData"></a>
 
-#### data.getData(filename) ⇒ <code>String</code>
+#### data.getData(filename, [source]) ⇒ <code>Object</code>
 Returns the data object with the given filename (JSON, stored in data folder).
 
 **Kind**: static method of [<code>data</code>](#util.data)  
-**Returns**: <code>String</code> - The data object.  
+**Returns**: <code>Object</code> - The data object.  
 
-| Param | Type | Description |
-| --- | --- | --- |
-| filename | <code>String</code> | The name of the data file. |
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| filename | <code>String</code> |  | The name of the data file. |
+| [source] | <code>String</code> | <code>data</code> | The source key defined under params.import of the config file. |
 
 **Example**  
 ```js
@@ -1001,27 +1106,60 @@ const data = util.data.getData("myTest");
 ```
 <a name="util.data.getSecureData"></a>
 
-#### data.getSecureData(filename) ⇒ <code>String</code>
+#### data.getSecureData(filename, [source]) ⇒ <code>Object</code>
 Returns and encrypts the data object with the given filename (JSON, stored in data folder). Will return the local file object if private key is not accessible.
 
 **Kind**: static method of [<code>data</code>](#util.data)  
-**Returns**: <code>String</code> - The encrypted or local data object.  
+**Returns**: <code>Object</code> - The encrypted or local data object.  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| filename | <code>String</code> |  | The name of the data file (without suffix '.secure' or '.local'). |
+| [source] | <code>String</code> | <code>data</code> | The source key defined under params.import of the config file. |
+
+**Example**  
+```js
+const secureData = util.data.getSecureData("myTest");
+```
+<a name="util.data.readDataFromFile"></a>
+
+#### data.readDataFromFile(filePath) ⇒ <code>Object</code>
+Reads the data object from the given filepath.
+
+**Kind**: static method of [<code>data</code>](#util.data)  
+**Returns**: <code>Object</code> - The data object.  
 
 | Param | Type | Description |
 | --- | --- | --- |
-| filename | <code>String</code> | The name of the data file (without suffix '.secure' or '.local'). |
+| filePath | <code>String</code> | The filepath. |
 
 **Example**  
 ```js
-const secureData = util.data.getSecureData("myTest");
+const data = util.data.readDataFromFile("./data/myData.json");
+```
+<a name="util.data.writeDataToFile"></a>
+
+#### data.writeDataToFile(filePath, data)
+Writes the data object to the given filepath.
+
+**Kind**: static method of [<code>data</code>](#util.data)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| filePath | <code>String</code> | The filepath. |
+| data | <code>Object</code> | The data object to write. |
+
+**Example**  
+```js
+const data = util.data.writeDataToFile("myTest");
 ```
 <a name="util.data.decrypt"></a>
 
-#### data.decrypt(data) ⇒ <code>String</code>
+#### data.decrypt(data) ⇒ <code>Object</code>
 Decrypts the passed input data.
 
 **Kind**: static method of [<code>data</code>](#util.data)  
-**Returns**: <code>String</code> - The decrypted data.  
+**Returns**: <code>Object</code> - The decrypted data.  
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -1372,11 +1510,11 @@ Global namespace for UI5 modules.
         * [.clickRevokeApproval([timeout])](#ui5.confirmationDialog.clickRevokeApproval)
     * [.control](#ui5.control)
         * [.execute(callbackFunction, selectorOrElement, args)](#ui5.control.execute)
-        * [.getProperty(elem, propertyName)](#ui5.control.getProperty)
-        * [.getAggregationProperty(elem, propertyName)](#ui5.control.getAggregationProperty)
-        * [.getAssociationProperty(elem, propertyName)](#ui5.control.getAssociationProperty)
-        * [.getBindingContextPathProperty(elem)](#ui5.control.getBindingContextPathProperty)
-        * [.getPropertyBinding(elem, propertyName)](#ui5.control.getPropertyBinding) ⇒ <code>Array</code>
+        * [.getProperty(selectorOrElement, propertyName)](#ui5.control.getProperty)
+        * [.getAggregationProperty(selectorOrElement, propertyName)](#ui5.control.getAggregationProperty)
+        * [.getAssociationProperty(selectorOrElement, propertyName)](#ui5.control.getAssociationProperty)
+        * [.getBindingContextPathProperty(selectorOrElement)](#ui5.control.getBindingContextPathProperty)
+        * [.getPropertyBinding(selectorOrElement, propertyName)](#ui5.control.getPropertyBinding) ⇒ <code>Array</code>
     * [.date](#ui5.date)
         * [.pick(selector, date, [index])](#ui5.date.pick)
         * [.pickRange(selector, range, [index])](#ui5.date.pickRange)
@@ -1444,7 +1582,7 @@ Global namespace for UI5 modules.
         * [.loginFiori(username, [password], [verify])](#ui5.session.loginFiori)
         * [.loginSapCloud(username, [password], [verify])](#ui5.session.loginSapCloud)
         * [.loginCustom(username, [password], usernameFieldSelector, passwordFieldSelector, logonButtonSelector, [verify])](#ui5.session.loginCustom)
-        * [.loginCustomViaConfig(username, password, [verify])](#ui5.session.loginCustomViaConfig)
+        * [.loginCustomViaConfig(username, [password], [verify])](#ui5.session.loginCustomViaConfig)
         * [.logout([verify])](#ui5.session.logout)
         * [.switchUser(username, [password], [authenticator], [wait])](#ui5.session.switchUser)
         * [.expectLogoutText()](#ui5.session.expectLogoutText)
@@ -1922,11 +2060,11 @@ await ui5.confirmationDialog.clickRevokeApproval();
 
 * [.control](#ui5.control)
     * [.execute(callbackFunction, selectorOrElement, args)](#ui5.control.execute)
-    * [.getProperty(elem, propertyName)](#ui5.control.getProperty)
-    * [.getAggregationProperty(elem, propertyName)](#ui5.control.getAggregationProperty)
-    * [.getAssociationProperty(elem, propertyName)](#ui5.control.getAssociationProperty)
-    * [.getBindingContextPathProperty(elem)](#ui5.control.getBindingContextPathProperty)
-    * [.getPropertyBinding(elem, propertyName)](#ui5.control.getPropertyBinding) ⇒ <code>Array</code>
+    * [.getProperty(selectorOrElement, propertyName)](#ui5.control.getProperty)
+    * [.getAggregationProperty(selectorOrElement, propertyName)](#ui5.control.getAggregationProperty)
+    * [.getAssociationProperty(selectorOrElement, propertyName)](#ui5.control.getAssociationProperty)
+    * [.getBindingContextPathProperty(selectorOrElement)](#ui5.control.getBindingContextPathProperty)
+    * [.getPropertyBinding(selectorOrElement, propertyName)](#ui5.control.getPropertyBinding) ⇒ <code>Array</code>
 
 <a name="ui5.control.execute"></a>
 
@@ -1938,7 +2076,7 @@ Executes a native UI5 action as callback function in the browser on the given UI
 | Param | Type | Description |
 | --- | --- | --- |
 | callbackFunction | <code>function</code> | The client script function to be used with the control instance. Caution: The first and last parameter is reserved for the mockserver instance and the promise resolve function - done. |
-| selectorOrElement | <code>String</code> \| <code>Object</code> | The selector object or the dom element (retrieved from getDisplayedElement). |
+| selectorOrElement | <code>Element</code> \| <code>Ui5Selector</code> \| <code>Ui5SelectorWithOptions</code> | The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed). |
 | args | <code>Object</code> | An object containing the arguments to pass to the callback function. |
 
 **Example**  
@@ -1951,81 +2089,81 @@ const title = await ui5.control.execute(function (control, args, done) {
 ```
 <a name="ui5.control.getProperty"></a>
 
-#### control.getProperty(elem, propertyName)
+#### control.getProperty(selectorOrElement, propertyName)
 Gets the UI5 control property of the given element.
 
 **Kind**: static method of [<code>control</code>](#ui5.control)  
 
 | Param | Type | Description |
 | --- | --- | --- |
-| elem | <code>Object</code> | The element. |
+| selectorOrElement | <code>Element</code> \| <code>Ui5Selector</code> \| <code>Ui5SelectorWithOptions</code> | The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed) |
 | propertyName | <code>String</code> | The property name of the control to retrieve the value from. |
 
 **Example**  
 ```js
 const selector = { "elementProperties":{"metadata":"sap.m.StandardListItem","mProperties":{ "title":[{"path":"CategoryName"}] }};
-const elem = await ui5.element.getDisplayedElement(selector);
+const elem = await ui5.element.getDisplayed(selector);
 const propertyName = "title";
 const val = await ui5.control.getProperty(elem, propertyName);
 ```
 <a name="ui5.control.getAggregationProperty"></a>
 
-#### control.getAggregationProperty(elem, propertyName)
+#### control.getAggregationProperty(selectorOrElement, propertyName)
 Gets the UI5 control aggregation property  of the given element.
 
 **Kind**: static method of [<code>control</code>](#ui5.control)  
 
 | Param | Type | Description |
 | --- | --- | --- |
-| elem | <code>Object</code> | The element. |
+| selectorOrElement | <code>Element</code> \| <code>Ui5Selector</code> \| <code>Ui5SelectorWithOptions</code> | The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed) |
 | propertyName | <code>String</code> | The aggregation property name of the control to retrieve the value from. |
 
 **Example**  
 ```js
 const selector = { "elementProperties":{"metadata":"sap.m.StandardListItem","mProperties":{ "items":[{"path":"/Categories"}] }};
-const elem = await ui5.element.getDisplayedElement(selector);
+const elem = await ui5.element.getDisplayed(selector);
 const propertyName = "tooltip";
 const val = await ui5.control.getAggregationProperty(elem, propertyName);
 ```
 <a name="ui5.control.getAssociationProperty"></a>
 
-#### control.getAssociationProperty(elem, propertyName)
+#### control.getAssociationProperty(selectorOrElement, propertyName)
 Get UI control property
 
 **Kind**: static method of [<code>control</code>](#ui5.control)  
 
 | Param | Type | Description |
 | --- | --- | --- |
-| elem | <code>Object</code> | The element. |
+| selectorOrElement | <code>Element</code> \| <code>Ui5Selector</code> \| <code>Ui5SelectorWithOptions</code> | The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed) |
 | propertyName | <code>String</code> | The association property name of the control to retrieve the value from. |
 
 **Example**  
 ```js
 const selector = { "elementProperties":{"metadata":"sap.m.MultiComboBox","mProperties":{}};
-const elem = await ui5.element.getDisplayedElement(selector);
+const elem = await ui5.element.getDisplayed(selector);
 const propertyName = "selectedItems";
 const propertyValue = await ui5.control.getAssociationProperty(elem, propertyName);
 ```
 <a name="ui5.control.getBindingContextPathProperty"></a>
 
-#### control.getBindingContextPathProperty(elem)
+#### control.getBindingContextPathProperty(selectorOrElement)
 Get UI control binding context path
 
 **Kind**: static method of [<code>control</code>](#ui5.control)  
 
 | Param | Type | Description |
 | --- | --- | --- |
-| elem | <code>Object</code> | The element. |
+| selectorOrElement | <code>Element</code> \| <code>Ui5Selector</code> \| <code>Ui5SelectorWithOptions</code> | The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed) |
 
 **Example**  
 ```js
 const selector = { "elementProperties":{"metadata":"sap.m.StandardListItem","mProperties":{"title":[{"path":"CategoryName"}] }};
-const elem = await ui5.element.getDisplayedElement(selector);
+const elem = await ui5.element.getDisplayed(selector);
 const context = await ui5.control.getBindingContextPathProperty(elem);
 ```
 <a name="ui5.control.getPropertyBinding"></a>
 
-#### control.getPropertyBinding(elem, propertyName) ⇒ <code>Array</code>
+#### control.getPropertyBinding(selectorOrElement, propertyName) ⇒ <code>Array</code>
 Get UI control property
 
 **Kind**: static method of [<code>control</code>](#ui5.control)  
@@ -2033,13 +2171,13 @@ Get UI control property
 
 | Param | Type | Description |
 | --- | --- | --- |
-| elem | <code>Object</code> | The element. |
+| selectorOrElement | <code>Element</code> \| <code>Ui5Selector</code> \| <code>Ui5SelectorWithOptions</code> | The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed) |
 | propertyName | <code>String</code> | The property name to retrieve from the control binding |
 
 **Example**  
 ```js
 const selector = { "elementProperties":{"metadata":"sap.m.StandardListItem","mProperties":{ "title":[{"path":"CategoryName"}] }};
-const elem = await ui5.element.getDisplayedElement(selector);
+const elem = await ui5.element.getDisplayed(selector);
 const propertyName = "title";
 const binding = await ui5.control.getPropertyBinding(elem, propertyName);
 ```
@@ -3086,7 +3224,7 @@ await ui5.qunit.executeTests("path/to/qunit.html");
     * [.loginFiori(username, [password], [verify])](#ui5.session.loginFiori)
     * [.loginSapCloud(username, [password], [verify])](#ui5.session.loginSapCloud)
     * [.loginCustom(username, [password], usernameFieldSelector, passwordFieldSelector, logonButtonSelector, [verify])](#ui5.session.loginCustom)
-    * [.loginCustomViaConfig(username, password, [verify])](#ui5.session.loginCustomViaConfig)
+    * [.loginCustomViaConfig(username, [password], [verify])](#ui5.session.loginCustomViaConfig)
     * [.logout([verify])](#ui5.session.logout)
     * [.switchUser(username, [password], [authenticator], [wait])](#ui5.session.switchUser)
     * [.expectLogoutText()](#ui5.session.expectLogoutText)
@@ -3101,7 +3239,7 @@ Login with specific username and password. This function works for both fiori an
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | username | <code>String</code> |  | The username. |
-| [password] | <code>String</code> | <code>&quot;super-duper-sensitive-pw&quot;</code> | The password. |
+| [password] | <code>String</code> |  | The password. |
 | [verify] | <code>Boolean</code> | <code>false</code> | Specifies if the function will check the shell header after logging in. |
 | [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
 
@@ -3123,7 +3261,7 @@ Login with fioriForm and specific username and password.
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | username | <code>String</code> |  | The username. |
-| [password] | <code>String</code> | <code>&quot;super-duper-sensitive-pw&quot;</code> | The password. |
+| [password] | <code>String</code> |  | The password. |
 | [verify] | <code>Boolean</code> | <code>false</code> | Specifies if the function will check the shell header after logging in. |
 
 **Example**  
@@ -3140,7 +3278,7 @@ Login with sapCloud form and specific username and password.
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | username | <code>String</code> |  | The username. |
-| [password] | <code>String</code> | <code>&quot;super-duper-sensitive-pw&quot;</code> | The password. |
+| [password] | <code>String</code> |  | The password. |
 | [verify] | <code>Boolean</code> | <code>false</code> | Specifies if the function will check the shell header after logging in. |
 
 **Example**  
@@ -3169,7 +3307,7 @@ await ui5.session.loginCustom("JOHN_DOE", "abc123!", "#username", #password, "#l
 ```
 <a name="ui5.session.loginCustomViaConfig"></a>
 
-#### session.loginCustomViaConfig(username, password, [verify])
+#### session.loginCustomViaConfig(username, [password], [verify])
 Login with specific username and password. The selectors will be taken from the config.
 
 **Kind**: static method of [<code>session</code>](#ui5.session)  
@@ -3177,7 +3315,7 @@ Login with specific username and password. The selectors will be taken from the
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | username | <code>String</code> |  | The username. Can be specified in spec or config. If specified in both credentials will be taken from config. |
-| password | <code>String</code> | <code>&quot;super-duper-sensitive-pw&quot;</code> | The password. Can be specified in spec or config. If specified in both credentials will be taken from config. |
+| [password] | <code>String</code> |  | The password. Can be specified in spec or config. If specified in both credentials will be taken from config. |
 | [verify] | <code>Boolean</code> | <code>false</code> | Specifies if the function will check the shell header after logging in. |
 
 **Example**  
@@ -3230,7 +3368,7 @@ switches the user according to the passed username and password.
 | Param | Type | Default | Description |
 | --- | --- | --- | --- |
 | username | <code>String</code> |  | The username. |
-| [password] | <code>String</code> | <code>&quot;super-duper-sensitive-pw&quot;</code> | The password. |
+| [password] | <code>String</code> |  | The password. |
 | [authenticator] | <code>Object</code> |  | The login form type. Set to null to use generic login. |
 | [wait] | <code>Number</code> | <code>10000</code> | The waiting time between logout and login (ms). |
 

package/lib/reuse/index.js

@@ -38,7 +38,8 @@ class ReuseLibrary {
             file: Util_1.default.file,
             formatter: Util_1.default.formatter,
             function: Util_1.default.function,
-            system: Util_1.default.system
+            system: Util_1.default.system,
+            component: Util_1.default.component
         };
         global.util = {
             ...util,
@@ -64,7 +65,7 @@ class ReuseLibrary {
             userInteraction: Ui5_1.default.userInteraction,
             qunit: Ui5_1.default.qunit,
             // data
-            authenticators: authenticators_json_1.default,
+            authenticators: authenticators_json_1.default
         };
         global.ui5 = {
             ...ui5,
@@ -97,8 +98,6 @@ class ReuseLibrary {
             ...global.service
         };
     }
-    ;
 }
-;
 exports.default = new ReuseLibrary();
 //# sourceMappingURL=index.js.map

package/lib/reuse/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reuse/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;AAEb,UAAU;AACV,+DAA2C;AAC3C,qEAAiD;AACjD,4DAAyC;AACzC,qEAAkD;AAClD,wEAAoD;AAEpD,OAAO;AACP,qFAAuD;AAEvD,MAAM,YAAY;IAChB,IAAI;QAEF;;;WAGG;QACH,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,gBAAW,CAAC,SAAS;YAChC,IAAI,EAAE,gBAAW,CAAC,IAAI;YACtB,UAAU,EAAE,gBAAW,CAAC,UAAU;YAClC,eAAe,EAAE,gBAAW,CAAC,eAAe;SAC7C,CAAC;QACF,MAAM,CAAC,MAAM,GAAG;YACd,GAAG,MAAM;YACT,GAAG,MAAM,CAAC,MAAM;SACjB,CAAC;QAEF;;;WAGG;QACH,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,cAAS,CAAC,OAAO;YAC1B,OAAO,EAAE,cAAS,CAAC,OAAO;YAC1B,IAAI,EAAE,cAAS,CAAC,IAAI;YACpB,IAAI,EAAE,cAAS,CAAC,IAAI;YACpB,SAAS,EAAE,cAAS,CAAC,SAAS;YAC9B,QAAQ,EAAE,cAAS,CAAC,QAAQ;YAC5B,MAAM,EAAE,cAAS,CAAC,MAAM;SACzB,CAAC;QACF,MAAM,CAAC,IAAI,GAAG;YACZ,GAAG,IAAI;YACP,GAAG,MAAM,CAAC,IAAI;SACf,CAAC;QAEF;;;WAGG;QACH,MAAM,GAAG,GAAG;YACV,SAAS,EAAE,aAAQ,CAAC,SAAS;YAC7B,kBAAkB,EAAE,aAAQ,CAAC,kBAAkB;YAC/C,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,aAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,aAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,SAAS,EAAE,aAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,aAAQ,CAAC,UAAU;YAC/B,UAAU,EAAE,aAAQ,CAAC,UAAU;YAC/B,aAAa,EAAE,aAAQ,CAAC,aAAa;YACrC,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,KAAK,EAAE,aAAQ,CAAC,KAAK;YACrB,eAAe,EAAE,aAAQ,CAAC,eAAe;YACzC,KAAK,EAAE,aAAQ,CAAC,KAAK;YACrB,OAAO;YACP,cAAc,EAAd,6BAAc;SACf,CAAC;QACF,MAAM,CAAC,GAAG,GAAG;YACX,GAAG,GAAG;YACN,GAAG,MAAM,CAAC,GAAG;SACd,CAAC;QAEF;;;WAGG;QACH,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,gBAAW,CAAC,SAAS;YAChC,OAAO,EAAE,gBAAW,CAAC,OAAO;YAC5B,UAAU,EAAE,gBAAW,CAAC,UAAU;YAClC,eAAe,EAAE,gBAAW,CAAC,eAAe;SAC7C,CAAC;QACF,MAAM,CAAC,MAAM,GAAG;YACd,GAAG,MAAM;YACT,GAAG,MAAM,CAAC,MAAM;SACjB,CAAC;QAEF;;;WAGG;QACH,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,iBAAY,CAAC,KAAK;YACzB,IAAI,EAAE,iBAAY,CAAC,IAAI;SACxB,CAAC;QACF,MAAM,CAAC,OAAO,GAAG;YACf,GAAG,OAAO;YACV,GAAG,MAAM,CAAC,OAAO;SAClB,CAAC;IACJ,CAAC;IAAA,CAAC;CACH;AAAA,CAAC;AAEF,kBAAe,IAAI,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reuse/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;AAEb,UAAU;AACV,+DAA4C;AAC5C,qEAAkD;AAClD,4DAAyC;AACzC,qEAAkD;AAClD,wEAAqD;AAErD,OAAO;AACP,qFAAwD;AAExD,MAAM,YAAY;IAChB,IAAI;QACF;;;WAGG;QACH,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,gBAAW,CAAC,SAAS;YAChC,IAAI,EAAE,gBAAW,CAAC,IAAI;YACtB,UAAU,EAAE,gBAAW,CAAC,UAAU;YAClC,eAAe,EAAE,gBAAW,CAAC,eAAe;SAC7C,CAAC;QACF,MAAM,CAAC,MAAM,GAAG;YACd,GAAG,MAAM;YACT,GAAG,MAAM,CAAC,MAAM;SACjB,CAAC;QAEF;;;WAGG;QACH,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,cAAS,CAAC,OAAO;YAC1B,OAAO,EAAE,cAAS,CAAC,OAAO;YAC1B,IAAI,EAAE,cAAS,CAAC,IAAI;YACpB,IAAI,EAAE,cAAS,CAAC,IAAI;YACpB,SAAS,EAAE,cAAS,CAAC,SAAS;YAC9B,QAAQ,EAAE,cAAS,CAAC,QAAQ;YAC5B,MAAM,EAAE,cAAS,CAAC,MAAM;YACxB,SAAS,EAAE,cAAS,CAAC,SAAS;SAC/B,CAAC;QACF,MAAM,CAAC,IAAI,GAAG;YACZ,GAAG,IAAI;YACP,GAAG,MAAM,CAAC,IAAI;SACf,CAAC;QAEF;;;WAGG;QACH,MAAM,GAAG,GAAG;YACV,SAAS,EAAE,aAAQ,CAAC,SAAS;YAC7B,kBAAkB,EAAE,aAAQ,CAAC,kBAAkB;YAC/C,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,aAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,aAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,SAAS,EAAE,aAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,aAAQ,CAAC,UAAU;YAC/B,UAAU,EAAE,aAAQ,CAAC,UAAU;YAC/B,aAAa,EAAE,aAAQ,CAAC,aAAa;YACrC,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,KAAK,EAAE,aAAQ,CAAC,KAAK;YACrB,eAAe,EAAE,aAAQ,CAAC,eAAe;YACzC,KAAK,EAAE,aAAQ,CAAC,KAAK;YACrB,OAAO;YACP,cAAc,EAAd,6BAAc;SACf,CAAC;QACF,MAAM,CAAC,GAAG,GAAG;YACX,GAAG,GAAG;YACN,GAAG,MAAM,CAAC,GAAG;SACd,CAAC;QAEF;;;WAGG;QACH,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,gBAAW,CAAC,SAAS;YAChC,OAAO,EAAE,gBAAW,CAAC,OAAO;YAC5B,UAAU,EAAE,gBAAW,CAAC,UAAU;YAClC,eAAe,EAAE,gBAAW,CAAC,eAAe;SAC7C,CAAC;QACF,MAAM,CAAC,MAAM,GAAG;YACd,GAAG,MAAM;YACT,GAAG,MAAM,CAAC,MAAM;SACjB,CAAC;QAEF;;;WAGG;QACH,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,iBAAY,CAAC,KAAK;YACzB,IAAI,EAAE,iBAAY,CAAC,IAAI;SACxB,CAAC;QACF,MAAM,CAAC,OAAO,GAAG;YACf,GAAG,OAAO;YACV,GAAG,MAAM,CAAC,OAAO;SAClB,CAAC;IACJ,CAAC;CACF;AAED,kBAAe,IAAI,YAAY,EAAE,CAAC"}

package/lib/reuse/modules/runtime/Runtime.d.ts

@@ -0,0 +1,5 @@
+export declare class Runtime {
+    specs: string[];
+}
+declare const _default: Runtime;
+export default _default;

package/lib/reuse/modules/runtime/Runtime.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Runtime = void 0;
+class Runtime {
+    constructor() {
+        this.specs = [];
+    }
+}
+exports.Runtime = Runtime;
+exports.default = new Runtime();
+//# sourceMappingURL=Runtime.js.map

package/lib/reuse/modules/runtime/Runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Runtime.js","sourceRoot":"","sources":["../../../../src/reuse/modules/runtime/Runtime.ts"],"names":[],"mappings":";;;AAAA,MAAa,OAAO;IAApB;QACS,UAAK,GAAa,EAAE,CAAC;IAC9B,CAAC;CAAA;AAFD,0BAEC;AAED,kBAAe,IAAI,OAAO,EAAE,CAAC"}

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

@@ -1,4 +1,5 @@
 import { Element } from "../../../../@types/wdio";
+import { Ui5Selector, Ui5SelectorWithOptions } from "./types/ui5.types";
 /**
  * @class control
  * @memberof ui5
@@ -12,7 +13,7 @@ export declare class Control {
      * @description Executes a native UI5 action as callback function in the browser on the given UI5 control.
      * @param {Function} callbackFunction - The client script function to be used with the control instance.
      * Caution: The first and last parameter is reserved for the mockserver instance and the promise resolve function - done.
-     * @param {String | Object} selectorOrElement - The selector object or the dom element (retrieved from getDisplayedElement).
+     * @param {Element | Ui5Selector | Ui5SelectorWithOptions} selectorOrElement - The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed).
      * @param {Object} args - An object containing the arguments to pass to the callback function.
      * @example const selector = {"elementProperties":{"metadata":"sap.m.StandardListItem", "id": "*categoryList-7"}};
      * const args = {"property": "text"};
@@ -20,66 +21,66 @@ export declare class Control {
      *   done(control.getProperty(args.property));
      * }, selector, args);
      **/
-    execute(callbackFunction: Function, selectorOrElement: any, args?: any): Promise<any>;
+    execute(callbackFunction: Function, selectorOrElement: Element | Ui5Selector | Ui5SelectorWithOptions, args?: any): Promise<any>;
     /**
      * @function getProperty
      * @memberOf ui5.control
      * @description Gets the UI5 control property of the given element.
-     * @param {Object} elem - The element.
+     * @param {Element | Ui5Selector | Ui5SelectorWithOptions} selectorOrElement - The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed)
      * @param {String} propertyName - The property name of the control to retrieve the value from.
      * @example const selector = { "elementProperties":{"metadata":"sap.m.StandardListItem","mProperties":{ "title":[{"path":"CategoryName"}] }};
-     * const elem = await ui5.element.getDisplayedElement(selector);
+     * const elem = await ui5.element.getDisplayed(selector);
      * const propertyName = "title";
      * const val = await ui5.control.getProperty(elem, propertyName);
      **/
-    getProperty(elem: Element, propertyName: string): Promise<any>;
+    getProperty(selectorOrElement: Element | Ui5Selector | Ui5SelectorWithOptions, propertyName: string): Promise<any>;
     /**
      * @function getAggregationProperty
      * @memberOf ui5.control
      * @description Gets the UI5 control aggregation property  of the given element.
-     * @param {Object} elem - The element.
+     * @param {Element | Ui5Selector | Ui5SelectorWithOptions} selectorOrElement - The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed)
      * @param {String} propertyName - The aggregation property name of the control to retrieve the value from.
      * @example const selector = { "elementProperties":{"metadata":"sap.m.StandardListItem","mProperties":{ "items":[{"path":"/Categories"}] }};
-     * const elem = await ui5.element.getDisplayedElement(selector);
+     * const elem = await ui5.element.getDisplayed(selector);
      * const propertyName = "tooltip";
      * const val = await ui5.control.getAggregationProperty(elem, propertyName);
      **/
-    getAggregationProperty(elem: Element, propertyName: string): Promise<any>;
+    getAggregationProperty(selectorOrElement: Element | Ui5Selector | Ui5SelectorWithOptions, propertyName: string): Promise<any>;
     /**
      * @function getAssociationProperty
      * @memberOf ui5.control
      * @description Get UI control property
-     * @param {Object} elem - The element.
+     * @param {Element | Ui5Selector | Ui5SelectorWithOptions} selectorOrElement - The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed)
      * @param {String} propertyName - The association property name of the control to retrieve the value from.
      * @example const selector = { "elementProperties":{"metadata":"sap.m.MultiComboBox","mProperties":{}};
-     * const elem = await ui5.element.getDisplayedElement(selector);
+     * const elem = await ui5.element.getDisplayed(selector);
      * const propertyName = "selectedItems";
      * const propertyValue = await ui5.control.getAssociationProperty(elem, propertyName);
      **/
-    getAssociationProperty(elem: Element, propertyName: string): Promise<any>;
+    getAssociationProperty(selectorOrElement: Element | Ui5Selector | Ui5SelectorWithOptions, propertyName: string): Promise<any>;
     /**
      * @function getBindingContextPathProperty
      * @memberOf ui5.control
      * @description Get UI control binding context path
-     * @param {Object} elem - The element.
+     * @param {Element | Ui5Selector | Ui5SelectorWithOptions} selectorOrElement - The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed)
      * @example const selector = { "elementProperties":{"metadata":"sap.m.StandardListItem","mProperties":{"title":[{"path":"CategoryName"}] }};
-     * const elem = await ui5.element.getDisplayedElement(selector);
+     * const elem = await ui5.element.getDisplayed(selector);
      * const context = await ui5.control.getBindingContextPathProperty(elem);
      **/
-    getBindingContextPathProperty(elem: Element): Promise<any>;
+    getBindingContextPathProperty(selectorOrElement: Element | Ui5Selector | Ui5SelectorWithOptions): Promise<any>;
     /**
      * @function getPropertyBinding
      * @memberOf ui5.control
      * @description Get UI control property
-     * @param {Object} elem - The element.
+     * @param {Element | Ui5Selector | Ui5SelectorWithOptions} selectorOrElement - The selector object, selector with options (selector, index, timeout) or the dom element (retrieved from ui5.element.getDisplayed)
      * @param {String} propertyName - The property name to retrieve from the control binding
      * @returns {Array} Array of bindings for the specific property
      * @example const selector = { "elementProperties":{"metadata":"sap.m.StandardListItem","mProperties":{ "title":[{"path":"CategoryName"}] }};
-     * const elem = await ui5.element.getDisplayedElement(selector);
+     * const elem = await ui5.element.getDisplayed(selector);
      * const propertyName = "title";
      * const binding = await ui5.control.getPropertyBinding(elem, propertyName);
      **/
-    getPropertyBinding(elem: Element, propertyName: string): Promise<any>;
+    getPropertyBinding(selectorOrElement: Element | Ui5Selector | Ui5SelectorWithOptions, propertyName: string): Promise<any>;
 }
 declare const _default: Control;
 export default _default;