@openui5/sap.ui.mdc 1.97.1 → 1.99.1

package/test/sap/ui/mdc/testutils/opa/filterbar/TestObjects.js

@@ -33,7 +33,7 @@ sap.ui.define([
 				 * 		Closes the personalization dialog.
 				 * 	</li>
 				 * </ol>
-				 * @param {sap.ui.core.Control | String} oFilterBar Instance / ID of the <code>FilterBar</code> that is filtered
+				 * @param {sap.ui.core.Control | string} oFilterBar Instance / ID of the <code>FilterBar</code> that is filtered
 				 * @param {Object} oSettings Map containing the settings for the filter personalization. Key is the label of the given group in the <code>FilterBar</code> personalization dialog, and value is an array containing the labels of the <code>FilterField</code>
 				 * @returns
 				 */
@@ -56,7 +56,7 @@ sap.ui.define([
 				 * 		Closes the personalization dialog.
 				 * 	</li>
 				 * </ol>
-				 * @param {sap.ui.core.Control | String} oFilterBar Instance / ID of the <code>FilterBar</code>
+				 * @param {sap.ui.core.Control | string} oFilterBar Instance / ID of the <code>FilterBar</code>
 				 * @returns
 				 */
 				iResetThePersonalization: function(oFilterBar) {
@@ -65,7 +65,7 @@ sap.ui.define([
 				/**
 				 * OPA5 test action
 				 * Presses the apply filters button of the <code>FilterBar</code>.
-				 * @param {sap.ui.core.Control | String} oFilterBar Instance / ID of the <code>FilterBar</code>
+				 * @param {sap.ui.core.Control | string} oFilterBar Instance / ID of the <code>FilterBar</code>
 				 * @returns
 				 */
 				iExpectSearch: function(oFilterBar) {
@@ -87,8 +87,8 @@ sap.ui.define([
 				 * 		Closes the personalization dialog.
 				 * 	</li>
 				 * </ol>
-				 * @param {sap.ui.core.Control | String} oFilterBar Instance / ID of the <code>FilterBar</code>
-				 * @param {String} sFilterLabel Label of the <code>FilterField</code>
+				 * @param {sap.ui.core.Control | string} oFilterBar Instance / ID of the <code>FilterBar</code>
+				 * @param {string} sFilterLabel Label of the <code>FilterField</code>
 				 * @param {Object} mSettings Map containing the settings for the filter values. Key is the label of the given group in the <code>FilterBar</code> personalization dialog, and value is an object containing the label of the <code>FilterField</code> and the values that are entered
 				 * @returns
 				 */
@@ -98,8 +98,8 @@ sap.ui.define([
 				/**
 				 * OPA5 test action
 				 * Clears all values of a <code>FilterField</code> with a given label on the <code>FilterBar</code>.
-				 * @param {sap.ui.core.Control | String} oFilterBar Instance / ID of the <code>FilterBar</code>
-				 * @param {String} sFilterLabel Label of the <code>FilterField</code>
+				 * @param {sap.ui.core.Control | string} oFilterBar Instance / ID of the <code>FilterBar</code>
+				 * @param {string} sFilterLabel Label of the <code>FilterField</code>
 				 * @returns
 				 */
 				iClearFilterValue: function(oFilterBar, sFilterLabel) {
@@ -123,8 +123,8 @@ sap.ui.define([
 				 * 		If the value is an empty array, the given <code>FilterFields</code> doesn't have a value.
 				 *  </li>
 				 * </ul>
-				 * @param {sap.ui.core.Control | String} oFilterBar Instance / ID of the <code>FilterBar</code>
-				 * @param {String[] | Object} vSettings
+				 * @param {sap.ui.core.Control | string} oFilterBar Instance / ID of the <code>FilterBar</code>
+				 * @param {string[] | Object} vSettings
 				 * @returns
 				 */
 				iShouldSeeFilters: function(oFilterBar, vSettings) {

package/test/sap/ui/mdc/testutils/opa/filterbar/Util.js

@@ -2,24 +2,25 @@
 * ! ${copyright}
 */
 sap.ui.define([
-], function() {
+	"sap/ui/core/Core"
+], function(oCore) {
 	"use strict";
 
-    var oMDCBundle = sap.ui.getCore().getLibraryResourceBundle("sap.ui.mdc");
-    //var oMBundle = sap.ui.getCore().getLibraryResourceBundle("sap.m");
+	var oMDCBundle = oCore.getLibraryResourceBundle("sap.ui.mdc");
+	//var oMBundle = oCore.getLibraryResourceBundle("sap.m");
 
 	var Util = {
 
-        texts: {
-            go: oMDCBundle.getText("filterbar.GO")
-        },
+		texts: {
+			go: oMDCBundle.getText("filterbar.GO")
+		},
 
-        icons: {
-            decline: "sap-icon://decline",
-            valueHelp: "sap-icon://value-help"
-        }
+		icons: {
+			decline: "sap-icon://decline",
+			valueHelp: "sap-icon://value-help"
+		}
 
-    };
+	};
 
 	return Util;
 });

package/test/sap/ui/mdc/testutils/opa/link/Actions.js

@@ -0,0 +1,85 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/test/matchers/Matcher",
+	"sap/ui/test/matchers/Properties",
+	"sap/ui/test/matchers/Ancestor",
+	"sap/ui/test/matchers/Descendant",
+	"sap/ui/test/matchers/PropertyStrictEquals",
+	"sap/ui/test/actions/Press",
+	"sap/ui/test/actions/EnterText",
+	"../p13n/Actions",
+	"../p13n/Util",
+    "./waitForLink"
+], function(
+	Opa5,
+	Matcher,
+	Properties,
+	Ancestor,
+	Descendant,
+	PropertyStrictEquals,
+	Press,
+	EnterText,
+	p13nActions,
+	p13nUtil,
+    waitForLink
+) {
+	"use strict";
+
+    return {
+        iPressTheLink: function(oLinkIdentifier) {
+            return waitForLink.call(this, oLinkIdentifier, {
+                actions: new Press()
+            });
+        },
+        iPressLinkOnPopover: function(oLinkIdentifier, sLink) {
+            return waitForLink.call(this, oLinkIdentifier, {
+                actions: new Press(),
+                success: function() {
+                    this.waitFor({
+						controlType: "sap.ui.mdc.link.Panel",
+						success: function(aPanels) {
+							Opa5.assert.equal(aPanels.length, 1, "mdc.link.Panel found");
+							var oPanel = aPanels[0];
+                            this.waitFor({
+                                controlType: "sap.m.Link",
+                                matchers: [
+                                    new Ancestor(oPanel, false),
+                                    new PropertyStrictEquals({
+                                        name: "text",
+                                        value: sLink
+                                    })
+                                ],
+                                actions: new Press(),
+                                success: function(aLinks) {
+                                    Opa5.assert.equal(aLinks.length, 1, "link on Panel found and pressed");
+                                }
+                            });
+                        }
+                    });
+                }
+            });
+        },
+        iCloseThePopover: function() {
+            this.waitFor({
+                controlType: "sap.ui.mdc.link.Panel",
+                success: function(aPanels) {
+                    Opa5.assert.equal(aPanels.length, 1, "mdc.link.Panel found");
+                    var oPanel = aPanels[0];
+
+                    this.waitFor({
+                        controlType: "sap.m.ResponsivePopover",
+                        matchers: new Descendant(oPanel),
+                        success: function(aResponsivePopovers) {
+                            Opa5.assert.equal(aResponsivePopovers.length, 1, "sap.m.ResponsivePopover found");
+                            aResponsivePopovers[0].close();
+                        }
+                    });
+                }
+            });
+        }
+    };
+});

package/test/sap/ui/mdc/testutils/opa/link/Assertions.js

@@ -0,0 +1,79 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/test/matchers/Matcher",
+	"sap/ui/test/matchers/Ancestor",
+    "sap/ui/test/matchers/Descendant",
+    "./waitForLink"
+], function(
+	Opa5,
+	Matcher,
+	Ancestor,
+    Descendant,
+    waitForLink
+) {
+	"use strict";
+
+    return {
+        iShouldSeeAPopover: function(oLinkIdentifier) {
+            return waitForLink.call(this, oLinkIdentifier, {
+                success: function(oLink) {
+                    this.waitFor({
+                        controlType: "sap.ui.mdc.Field",
+                        matchers: new Descendant(oLink, true),
+                        success: function(aFields) {
+                            this.waitFor({
+                                controlType: "sap.m.Popover",
+                                matchers: new Ancestor(aFields[0].getFieldInfo(), false),
+                                success: function(aPopovers) {
+                                    Opa5.assert.equal(aPopovers.length, 1, "Popover of mdc.Link found");
+                                }
+                            });
+                        }
+                    });
+                }
+            });
+        },
+        iShouldSeeLinksOnPopover: function(oLinkIdentifier, aLinks) {
+            return waitForLink.call(this, oLinkIdentifier, {
+                success: function() {
+                    this.waitFor({
+                        controlType: "sap.ui.mdc.link.Panel",
+                        success: function(aPanels) {
+                            Opa5.assert.equal(aPanels.length, 1, "mdc.link.Panel found");
+                            var oPanel = aPanels[0];
+                            var iIndex = 0;
+                            var oMatcher = new Matcher();
+                            oMatcher.isMatching = function(oLink) {
+                                var bTextMatching = oLink.getText() === aLinks[iIndex];
+                                iIndex++;
+                                return bTextMatching;
+                            };
+                            if (aLinks.length > 0) {
+                                this.waitFor({
+                                    controlType: "sap.m.Link",
+                                    matchers: [
+                                        new Ancestor(oPanel, false),
+                                        oMatcher
+                                    ],
+                                    success: function(aLinkControls) {
+                                        Opa5.assert.equal(aLinks.length, aLinkControls.length, aLinks.length + " Links on Popover found");
+                                    }
+                                });
+                            } else {
+                                var aVisibleItems = oPanel.getItems().filter(function(oItem) {
+                                    return oItem.getVisible();
+                                });
+                                Opa5.assert.equal(aVisibleItems.length, 0, aVisibleItems.length + " Links on Popover found");
+                            }
+                        }
+                    });
+                }
+            });
+        }
+    };
+
+});

package/test/sap/ui/mdc/testutils/opa/link/TestObjects.js

@@ -0,0 +1,112 @@
+/*!
+ * ${copyright}
+ */
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"./Actions",
+	"./Assertions",
+	"../p13n/Actions",
+    "./waitForLink"
+], function(
+	Opa5,
+	linkActions,
+	linkAssertions,
+	p13nActions,
+    waitForLink
+) {
+	"use strict";
+
+	Opa5.createPageObjects({
+		onTheMDCLink: {
+			actions: {
+                /**
+                 * Object to identify a <code>sap.ui.mdc.Link</code>. Should contain at least one of the following properties: <code>text</code> and <code>id</code>.
+                 * @typedef {object} LinkIdentifier
+                 * @property {string} id ID of a given <code>sap.m.Link</code> that represents the <code>sap.ui.mdc.Link</code>
+                 * @property {string} text Text of a given <code>sap.m.Link</code> that represents the <code>sap.ui.mdc.Link</code>
+                 */
+                /**
+                 * Opa5 test action
+                 * @param {LinkIdentifier} oLinkIdentifier The object to identify the <code>sap.ui.mdc.Link</code>
+                 * @param {string[]} aLinks Array containing the texts of the links that are the result of the personalization
+                 * @returns {Promise} OPA waitFor
+                 * 1. Opens the personalization dialog of a given <code>sap.ui.mdc.Link</code>.
+                 * 2. Selects all links given by <code>aLinks</code> and deselects all other links.
+                 * 3. Closes the personalization dialog.
+                 */
+                iPersonalizeTheLinks: function(oLinkIdentifier, aLinks) {
+                    return waitForLink.call(this, oLinkIdentifier, {
+                        success: function(oLink) {
+                            p13nActions.iPersonalizeLink.call(this, oLink, aLinks);
+                        }
+                    });
+                },
+                /**
+                 * Opa5 test action
+                 * @param {LinkIdentifier} oLinkIdentifier The object to identify the <code>sap.ui.mdc.Link</code> that is reset
+                 * @returns {Promise} OPA waitFor
+                 * 1. Opens the personalization dialog of a given <code>sap.ui.mdc.Link</code>.
+                 * 2. Presses the Reset personalization button.
+                 * 3. Confirms the Reset dialog.
+                 * 4. Closes the personalization dialog.
+                 */
+                iResetThePersonalization: function(oLinkIdentifier) {
+                    return waitForLink.call(this, oLinkIdentifier, {
+                        success: function(oLink) {
+                            p13nActions.iResetThePersonalization.call(this, oLink);
+                        }
+                    });
+                },
+                /**
+                * Opa5 test action
+                * @param {LinkIdentifier} oLinkIdentifier The object to identify the <code>sap.ui.mdc.Link</code> that is pressed
+                * @returns {Promise} OPA waitFor
+                */
+                iPressTheLink: function(oLinkIdentifier) {
+                    return linkActions.iPressTheLink.call(this, oLinkIdentifier);
+                },
+                /**
+                * Opa5 test action
+                * @param {LinkIdentifier} oLinkIdentifier The object to identify the <code>sap.ui.mdc.Link</code> that opens the popover
+                * @param {string} sLink The text of the link that is to be clicked on the popover
+                * @returns {Promise} OPA waitFor
+                * 1. Presses a given <code>sap.ui.mdc.Link</code> to open its popover.
+                * 2. Presses a link on the opened popover defined by <code>sLink</code>.
+                */
+                iPressLinkOnPopover: function(oLinkIdentifier, sLink) {
+                    return linkActions.iPressLinkOnPopover.call(this, oLinkIdentifier, sLink);
+                },
+                /**
+                 * Opa5 test action
+                 * @returns {Promise} OPA waitFor
+                 * Closes an open popover of the <code>sap.ui.mdc.Link</code>.
+                 */
+                iCloseThePopover: function() {
+                    return linkActions.iCloseThePopover.call(this);
+                }
+            },
+            assertions: {
+                /**
+                * Opa5 test action
+                * @param {LinkIdentifier} oLinkIdentifier The object to identify the <code>sap.ui.mdc.Link</code> that opens the popover
+                * @returns {Promise} OPA waitFor
+                * Creates an assumption that there is an open popover for a given <code>sap.ui.mdc.Link</code>.
+                */
+                iShouldSeeAPopover: function(oLinkIdentifier) {
+                    return linkAssertions.iShouldSeeAPopover.call(this, oLinkIdentifier);
+                },
+                /**
+                 * Opa5 test action
+                 * @param {LinkIdentifier} oLinkIdentifier The object to identify the <code>sap.ui.mdc.Link</code> that opens the popover
+                 * @param {string[]} aLinks Array containing the texts of the links that are visible on the popover
+                 * @returns {Promise} OPA waitFor
+                 * Creates an assumption that there is an open popover for a given <code>sap.ui.mdc.Link</code> and checks that all given links defined in <code>aLinks</code> are on that popover in a defined order.
+                 */
+                iShouldSeeLinksOnPopover: function(oLinkIdentifier, aLinks) {
+                    return linkAssertions.iShouldSeeLinksOnPopover.call(this, oLinkIdentifier, aLinks);
+                }
+            }
+        }
+    });
+
+});

package/test/sap/ui/mdc/testutils/opa/link/waitForLink.js

@@ -0,0 +1,50 @@
+/*!
+ * ${copyright}
+ */
+sap.ui.define([
+	"sap/ui/test/Opa5",
+    "sap/ui/test/matchers/PropertyStrictEquals"
+], function(
+	Opa5,
+    PropertyStrictEquals
+) {
+	"use strict";
+
+	return function waitForLink(oLinkIdentifier, oSettings) {
+        var sText = oLinkIdentifier.text;
+        var sId = oLinkIdentifier.id;
+        Opa5.assert.ok(sText || sId, "LinkIdentifier correct Text: '" + sText + "' - ID: '" + sId + "'");
+        var fnCallSuccess = function(oLink) {
+            if (typeof oSettings.success === "function") {
+                oSettings.success.call(this, oLink);
+            }
+        };
+
+        var oOpaSettings = {
+            controlType: "sap.m.Link",
+            actions: oSettings.actions
+        };
+
+        if (sText) {
+            oOpaSettings.matchers = new PropertyStrictEquals({
+                name: "text",
+                value: sText
+            });
+        }
+
+        if (sId) {
+            oOpaSettings.id = sId;
+            oOpaSettings.success = function(oLinkControl) {
+                Opa5.assert.ok(oLinkControl, "sap.ui.mdc.Link found");
+                fnCallSuccess.call(this, oLinkControl);
+            };
+        } else {
+            oOpaSettings.success = function(aLinkControls) {
+                Opa5.assert.equal(aLinkControls.length, 1, "sap.ui.mdc.Link found");
+                fnCallSuccess.call(this, aLinkControls[0]);
+            };
+        }
+
+        return this.waitFor(oOpaSettings);
+    };
+});