@sapui5/sap.fe.test 1.100.0 → 1.102.0

package/src/sap/fe/test/api/HeaderAssertions.js

@@ -12,7 +12,7 @@ sap.ui.define(
 		"sap/fe/test/builder/MacroFieldBuilder",
 		"./APIHelper"
 	],
-	function(HeaderAPI, Utils, OpaBuilder, FEBuilder, FieldBuilder, APIHelper) {
+	function (HeaderAPI, Utils, OpaBuilder, FEBuilder, FieldBuilder, APIHelper) {
 		"use strict";
 
 		/**
@@ -26,7 +26,7 @@ sap.ui.define(
 		 * @hideconstructor
 		 * @public
 		 */
-		var HeaderAssertions = function(oHeaderBuilder, vHeaderDescription) {
+		var HeaderAssertions = function (oHeaderBuilder, vHeaderDescription) {
 			this._sObjectPageLayoutId = vHeaderDescription.id;
 			this._sHeaderId = vHeaderDescription.headerId;
 			this._sHeaderContentId = vHeaderDescription.headerContentId;
@@ -48,7 +48,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckAction = function(vActionIdentifier, mState) {
+		HeaderAssertions.prototype.iCheckAction = function (vActionIdentifier, mState) {
 			var oOverflowToolbarBuilder = this.createOverflowToolbarBuilder(this._sObjectPageLayoutId);
 			return this.prepareResult(
 				oOverflowToolbarBuilder
@@ -66,7 +66,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckEdit = function(mState) {
+		HeaderAssertions.prototype.iCheckEdit = function (mState) {
 			return this.iCheckAction({ service: "StandardAction", action: "Edit", unbound: true }, mState);
 		};
 
@@ -78,7 +78,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckDelete = function(mState) {
+		HeaderAssertions.prototype.iCheckDelete = function (mState) {
 			return this.iCheckAction({ service: "StandardAction", action: "Delete", unbound: true }, mState);
 		};
 
@@ -90,7 +90,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckRelatedApps = function(mState) {
+		HeaderAssertions.prototype.iCheckRelatedApps = function (mState) {
 			return this.iCheckAction({ service: "fe", action: "RelatedApps", unbound: true }, mState);
 		};
 
@@ -102,7 +102,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckMenuAction = function(vAction) {
+		HeaderAssertions.prototype.iCheckMenuAction = function (vAction) {
 			return this.prepareResult(APIHelper.createMenuActionCheckBuilder(vAction).execute());
 		};
 
@@ -115,15 +115,15 @@ sap.ui.define(
 		 *
 		 * @ui5-restricted
 		 */
-		HeaderAssertions.prototype.iCheckNumberOfHeaderContentItems = function(iNumberOfItems, bIncludeHidden) {
+		HeaderAssertions.prototype.iCheckNumberOfHeaderContentItems = function (iNumberOfItems, bIncludeHidden) {
 			var oHeaderContentBuilder = this.getObjectPageDynamicHeaderContentBuilder(this._sHeaderContentId);
 
 			return this.prepareResult(
 				oHeaderContentBuilder
-					.has(function(oOPHeaderContent) {
+					.has(function (oOPHeaderContent) {
 						var aItems = oOPHeaderContent.getContent()[0].getItems();
 						if (!bIncludeHidden) {
-							aItems = aItems.filter(function(oControl) {
+							aItems = aItems.filter(function (oControl) {
 								return oControl.getVisible();
 							});
 						}
@@ -151,7 +151,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckFieldInFieldGroup = function(vFieldIdentifier, vValue, mState) {
+		HeaderAssertions.prototype.iCheckFieldInFieldGroup = function (vFieldIdentifier, vValue, mState) {
 			var aArguments = Utils.parseArguments([Object, [Array, String], Object], arguments),
 				sFieldId =
 					(vFieldIdentifier.targetAnnotation
@@ -184,7 +184,7 @@ sap.ui.define(
 		 *
 		 * @ui5-restricted
 		 */
-		HeaderAssertions.prototype.iCheckDataPoint = function(sTitle, sValue) {
+		HeaderAssertions.prototype.iCheckDataPoint = function (sTitle, sValue) {
 			var oHeaderContentBuilder = this.getObjectPageDynamicHeaderContentBuilder(this._sHeaderContentId);
 
 			return this.prepareResult(
@@ -194,7 +194,7 @@ sap.ui.define(
 							OpaBuilder.create(this)
 								.hasType("sap.m.ObjectNumber")
 								.hasProperties({ number: sValue })
-								.has(function(oObjectNumber) {
+								.has(function (oObjectNumber) {
 									return oObjectNumber.getParent();
 								})
 								.hasAggregationProperties("items", { text: sTitle })
@@ -216,24 +216,18 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckTitle = function(sTitle, sDescription) {
+		HeaderAssertions.prototype.iCheckTitle = function (sTitle, sDescription) {
 			var oHeaderTitleBuilder = this.getObjectPageDynamicHeaderTitleBuilder(this._sObjectPageLayoutId);
 			return this.prepareResult(
 				oHeaderTitleBuilder
 					.hasConditional(
 						sTitle !== undefined,
-						OpaBuilder.Matchers.childrenMatcher(
-							OpaBuilder.create(this)
-								.hasType("sap.m.Title")
-								.hasProperties({ text: sTitle })
-						)
+						OpaBuilder.Matchers.childrenMatcher(OpaBuilder.create(this).hasType("sap.m.Title").hasProperties({ text: sTitle }))
 					)
 					.hasConditional(
 						sDescription !== undefined,
 						OpaBuilder.Matchers.childrenMatcher(
-							OpaBuilder.create(this)
-								.hasType("sap.m.Label")
-								.hasProperties({ text: sDescription })
+							OpaBuilder.create(this).hasType("sap.m.Label").hasProperties({ text: sDescription })
 						)
 					)
 					.description(
@@ -253,7 +247,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckPaginatorDown = function(mState) {
+		HeaderAssertions.prototype.iCheckPaginatorDown = function (mState) {
 			return this.prepareResult(
 				this.createPaginatorBuilder(
 					OpaBuilder.Matchers.properties({ icon: "sap-icon://navigation-down-arrow" }),
@@ -273,7 +267,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckPaginatorUp = function(mState) {
+		HeaderAssertions.prototype.iCheckPaginatorUp = function (mState) {
 			return this.prepareResult(
 				this.createPaginatorBuilder(
 					OpaBuilder.Matchers.properties({ icon: "sap-icon://navigation-up-arrow" }),
@@ -294,7 +288,7 @@ sap.ui.define(
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 		 * @ui5-restricted
 		 */
-		HeaderAssertions.prototype.iCheckMicroChart = function(vMicroChartIdentifier, sUoMLabel) {
+		HeaderAssertions.prototype.iCheckMicroChart = function (vMicroChartIdentifier, sUoMLabel) {
 			var oOpaBuilder = OpaBuilder.create(this.getOpaInstance());
 
 			if (!Utils.isOfType(vMicroChartIdentifier, String)) {
@@ -349,7 +343,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckHeaderFacet = function(vFacetIdentifier, mState) {
+		HeaderAssertions.prototype.iCheckHeaderFacet = function (vFacetIdentifier, mState) {
 			var aArguments = Utils.parseArguments([[Object, String], Object], arguments),
 				oHeaderContentBuilder = this.getObjectPageDynamicHeaderContentBuilder(this._sHeaderContentId),
 				sId = new RegExp("fe::HeaderFacetContainer::" + vFacetIdentifier.facetId + "$");
@@ -362,13 +356,7 @@ sap.ui.define(
 
 			return this.prepareResult(
 				oHeaderContentBuilder
-					.has(
-						OpaBuilder.Matchers.childrenMatcher(
-							FEBuilder.create(this.getOpaInstance())
-								.hasId(sId)
-								.hasState(mState)
-						)
-					)
+					.has(OpaBuilder.Matchers.childrenMatcher(FEBuilder.create(this.getOpaInstance()).hasId(sId).hasState(mState)))
 					.description(Utils.formatMessage("Checking Header Facet '{0}' with state='{1}'", aArguments[0], aArguments[1]))
 					.execute()
 			);
@@ -390,7 +378,7 @@ sap.ui.define(
 		 *
 		 * @ui5-restricted
 		 */
-		HeaderAssertions.prototype.iCheckBreadCrumb = function(sLink) {
+		HeaderAssertions.prototype.iCheckBreadCrumb = function (sLink) {
 			var oFEBuilder = FEBuilder.create(this.getOpaInstance()).hasId(this._sBreadCrumbId);
 
 			if (sLink !== undefined && sLink.length > 0) {
@@ -416,7 +404,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckSaveAsTile = function(mState) {
+		HeaderAssertions.prototype.iCheckSaveAsTile = function (mState) {
 			var oOverflowToolbarBuilder = this.createOverflowToolbarBuilder(this._sObjectPageLayoutId),
 				sShareId = "fe::Share";
 
@@ -442,7 +430,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		HeaderAssertions.prototype.iCheckSendEmail = function(mState) {
+		HeaderAssertions.prototype.iCheckSendEmail = function (mState) {
 			var oOverflowToolbarBuilder = this.createOverflowToolbarBuilder(this._sObjectPageLayoutId),
 				sShareId = "fe::Share";
 
@@ -471,7 +459,7 @@ sap.ui.define(
 		 *
 		 * @private
 		 */
-		HeaderAssertions.prototype.iCheckLink = function(vLinkIdentifier, mState) {
+		HeaderAssertions.prototype.iCheckLink = function (vLinkIdentifier, mState) {
 			// TODO this function needs to aligned with onForm().iCheckLink - for now vLinkIdentifier must be the link text!
 			var aArguments = Utils.parseArguments([String, Object], arguments),
 				oHeaderContentBuilder = this.getObjectPageDynamicHeaderContentBuilder(this._sHeaderContentId);
@@ -479,10 +467,7 @@ sap.ui.define(
 				oHeaderContentBuilder
 					.has(
 						OpaBuilder.Matchers.childrenMatcher(
-							FEBuilder.create()
-								.hasType("sap.m.Link")
-								.hasProperties({ text: vLinkIdentifier })
-								.hasState(aArguments[1])
+							FEBuilder.create().hasType("sap.m.Link").hasProperties({ text: vLinkIdentifier }).hasState(aArguments[1])
 						)
 					)
 					.description(Utils.formatMessage("Checking link '{0}' with state='{1}'", aArguments[0], aArguments[1]))
@@ -490,6 +475,56 @@ sap.ui.define(
 			);
 		};
 
+		/**
+		 * Checks the number of users collaborating in the draft.
+		 *
+		 * @param {number} iExpectedNumber The expected number of users
+		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
+		 *
+		 * @ui5-restricted
+		 */
+		HeaderAssertions.prototype.iCheckNumberOfCollaboratingUsers = function (iExpectedNumber) {
+			var objectPageBuilder = FEBuilder.create(this.getOpaInstance()).hasId(this._sObjectPageLayoutId);
+
+			return this.prepareResult(
+				objectPageBuilder
+					.hasChildren(
+						FEBuilder.create(this)
+							.hasType("sap.uxap.ObjectPageDynamicHeaderTitle")
+							.hasChildren(
+								FEBuilder.create(this)
+									.hasType("sap.m.Avatar")
+									.checkNumberOfMatches(iExpectedNumber + 1) // +1 because of avatar to add a user
+							)
+					)
+					.description(Utils.formatMessage("Checking number of collaborating user: {0}", iExpectedNumber))
+					.execute()
+			);
+		};
+
+		/**
+		 * Checks if a collaborating user is present.
+		 *
+		 * @param {string} sInitials The initials of the user (displayed in the avatar)
+		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
+		 *
+		 * @ui5-restricted
+		 */
+		HeaderAssertions.prototype.iCheckCollaboratingUser = function (sInitials) {
+			var objectPageBuilder = FEBuilder.create(this.getOpaInstance()).hasId(this._sObjectPageLayoutId);
+
+			return this.prepareResult(
+				objectPageBuilder
+					.hasChildren(
+						FEBuilder.create(this)
+							.hasType("sap.uxap.ObjectPageDynamicHeaderTitle")
+							.hasChildren(FEBuilder.create(this).hasType("sap.m.Avatar").hasProperties({ initials: sInitials }))
+					)
+					.description(Utils.formatMessage("Checking collaborating user with initials '{0}'", sInitials))
+					.execute()
+			);
+		};
+
 		return HeaderAssertions;
 	}
 );

package/src/sap/fe/test/api/TableAPI.js

@@ -14,7 +14,7 @@ sap.ui.define(
 		"sap/ui/test/actions/Action",
 		"sap/ui/core/SortOrder"
 	],
-	function(BaseAPI, Utils, FEBuilder, TableBuilder, DialogBuilder, OpaBuilder, Action, SortOrder) {
+	function (BaseAPI, Utils, FEBuilder, TableBuilder, DialogBuilder, OpaBuilder, Action, SortOrder) {
 		"use strict";
 
 		/**
@@ -38,7 +38,7 @@ sap.ui.define(
 		 * @hideconstructor
 		 * @public
 		 */
-		var TableAPI = function(oTableBuilder, vTableDescription) {
+		var TableAPI = function (oTableBuilder, vTableDescription) {
 			if (!Utils.isOfType(oTableBuilder, TableBuilder)) {
 				throw new Error("oTableBuilder parameter must be an TableBuilder instance");
 			}
@@ -47,13 +47,13 @@ sap.ui.define(
 		TableAPI.prototype = Object.create(BaseAPI.prototype);
 		TableAPI.prototype.constructor = TableAPI;
 
-		TableAPI.createRowMatchers = function(vRowValues, mRowState, vAdditionalMatchers, vEmptyCells) {
+		TableAPI.createRowMatchers = function (vRowValues, mRowState, vAdditionalMatchers, vEmptyCells) {
 			var aArguments = Utils.parseArguments([[Object, Number], Object, [Array, Function], Array], arguments),
 				aRowMatchers = [];
 			if (Utils.isOfType(aArguments[0], Object)) {
 				aRowMatchers.push(TableBuilder.Row.Matchers.cellValues(aArguments[0]));
 			} else if (Utils.isOfType(aArguments[0], Number)) {
-				aRowMatchers.push(function(oRow) {
+				aRowMatchers.push(function (oRow) {
 					var oRowParent = oRow.getParent(),
 						sParentAggregation = oRow.sParentAggregationName;
 					return oRowParent && sParentAggregation
@@ -73,7 +73,7 @@ sap.ui.define(
 			return aRowMatchers;
 		};
 
-		TableAPI.prototype.createGroupRowMatchers = function(iLevel, sTitle) {
+		TableAPI.prototype.createGroupRowMatchers = function (iLevel, sTitle) {
 			return [TableBuilder.Row.Matchers.visualGroup(iLevel, sTitle)];
 		};
 
@@ -84,7 +84,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		TableAPI.prototype.iOpenColumnAdaptation = function() {
+		TableAPI.prototype.iOpenColumnAdaptation = function () {
 			var oTableBuilder = this.getBuilder();
 			return this.prepareResult(
 				oTableBuilder
@@ -103,7 +103,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		TableAPI.prototype.iConfirmColumnAdaptation = function() {
+		TableAPI.prototype.iConfirmColumnAdaptation = function () {
 			return this.prepareResult(
 				TableBuilder.createAdaptationDialogBuilder(this.getOpaInstance())
 					.doPressFooterButton(OpaBuilder.Matchers.resourceBundle("text", "sap.ui.mdc", "p13nDialog.OK"))
@@ -121,7 +121,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		TableAPI.prototype.iOpenColumnSorting = function() {
+		TableAPI.prototype.iOpenColumnSorting = function () {
 			var oTableBuilder = this.getBuilder();
 			return this.prepareResult(
 				oTableBuilder
@@ -138,7 +138,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		TableAPI.prototype.iConfirmColumnSorting = function() {
+		TableAPI.prototype.iConfirmColumnSorting = function () {
 			return this.prepareResult(
 				TableBuilder.createSortingDialogBuilder(this.getOpaInstance())
 					.doPressFooterButton(OpaBuilder.Matchers.resourceBundle("text", "sap.ui.mdc", "p13nDialog.OK"))
@@ -156,7 +156,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		TableAPI.prototype.iOpenFilterDialog = function() {
+		TableAPI.prototype.iOpenFilterDialog = function () {
 			var oTableBuilder = this.getBuilder();
 			return this.prepareResult(
 				oTableBuilder
@@ -173,7 +173,7 @@ sap.ui.define(
 		 *
 		 * @public
 		 */
-		TableAPI.prototype.iConfirmFilterDialog = function() {
+		TableAPI.prototype.iConfirmFilterDialog = function () {
 			return this.prepareResult(
 				TableBuilder.createFilteringDialogBuilder(this.getOpaInstance())
 					.doPressFooterButton(OpaBuilder.Matchers.resourceBundle("text", "sap.ui.mdc", "p13nDialog.OK"))
@@ -203,7 +203,7 @@ sap.ui.define(
 		 *
 		 * @ui5-restricted
 		 */
-		TableAPI.prototype.personalization = function(
+		TableAPI.prototype.personalization = function (
 			vColumnIdentifier,
 			mState,
 			vActions,
@@ -218,9 +218,7 @@ sap.ui.define(
 				),
 				oBuilder = FEBuilder.create(this.getOpaInstance()),
 				bDialogOpen,
-				oAdaptColumnBuilder = FEBuilder.create(this.getOpaInstance())
-					.hasType("sap.m.ColumnListItem")
-					.isDialogElement();
+				oAdaptColumnBuilder = FEBuilder.create(this.getOpaInstance()).hasType("sap.m.ColumnListItem").isDialogElement();
 
 			oDialogBuilder = aArguments[4];
 			fnOpenDialog = aArguments[5];
@@ -255,7 +253,7 @@ sap.ui.define(
 			sDescription = aArguments[3];
 			return this.prepareResult(
 				oBuilder
-					.success(function() {
+					.success(function () {
 						bDialogOpen = FEBuilder.controlsExist(oDialogBuilder);
 						if (!bDialogOpen) {
 							fnOpenDialog();
@@ -263,7 +261,7 @@ sap.ui.define(
 						}
 						return oDialogBuilder
 							.has(OpaBuilder.Matchers.children(oAdaptColumnBuilder))
-							.has(function(aFoundAdaptationColumns) {
+							.has(function (aFoundAdaptationColumns) {
 								if (bCheckForNotVisible) {
 									return aFoundAdaptationColumns.length === 0;
 								}
@@ -296,7 +294,7 @@ sap.ui.define(
 		 *
 		 * @ui5-restricted
 		 */
-		TableAPI.prototype.sortingPersonalization = function(
+		TableAPI.prototype.sortingPersonalization = function (
 			vColumnIdentifier,
 			mState,
 			vActions,
@@ -311,13 +309,9 @@ sap.ui.define(
 				),
 				oBuilder = FEBuilder.create(this.getOpaInstance()),
 				bDialogOpen,
-				oAdaptColumnBuilder = FEBuilder.create(this.getOpaInstance())
-					.hasType("sap.m.CustomListItem")
-					.isDialogElement(),
+				oAdaptColumnBuilder = FEBuilder.create(this.getOpaInstance()).hasType("sap.m.CustomListItem").isDialogElement(),
 				oNoneColumnMatcher = OpaBuilder.Matchers.childrenMatcher(
-					OpaBuilder.create()
-						.hasType("sap.m.Select")
-						.hasProperties({ selectedKey: "$_none" })
+					OpaBuilder.create().hasType("sap.m.ComboBox").hasProperties({ placeholder: "Sort by" })
 				),
 				oTargetColumnMatcher;
 
@@ -329,29 +323,31 @@ sap.ui.define(
 			if (Utils.isOfType(vColumnIdentifier, String)) {
 				oTargetColumnMatcher = OpaBuilder.Matchers.childrenMatcher(
 					OpaBuilder.create(this.getOpaInstance())
-						.hasType("sap.m.Select")
-						.has(function(oSelectControl) {
-							return oSelectControl.getSelectedItem().getText() === vColumnIdentifier;
+						.hasType("sap.m.ComboBox")
+						.has(function (oSelectControl) {
+							return oSelectControl.getSelectedItem()
+								? oSelectControl.getSelectedItem().getText() === vColumnIdentifier
+								: false;
 						})
 				);
 			} else {
 				oTargetColumnMatcher = OpaBuilder.Matchers.childrenMatcher(
 					OpaBuilder.create(this.getOpaInstance())
-						.hasType("sap.m.Select")
+						.hasType("sap.m.ComboBox")
 						.hasProperties({ selectedKey: vColumnIdentifier.name })
 				);
 			}
 
 			oDialogBuilder
 				.has(OpaBuilder.Matchers.children(oAdaptColumnBuilder))
-				.has(function(aCustomListItems) {
+				.has(function (aCustomListItems) {
 					var aMatchingListItems = OpaBuilder.Matchers.filter(oTargetColumnMatcher)(aCustomListItems);
 					if (aMatchingListItems.length) {
 						return aMatchingListItems;
 					}
 					return OpaBuilder.Matchers.filter(oNoneColumnMatcher)(aCustomListItems);
 				})
-				.has(function(aFoundAdaptationColumns) {
+				.has(function (aFoundAdaptationColumns) {
 					if (bCheckForNotVisible) {
 						return aFoundAdaptationColumns.length === 0;
 					}
@@ -367,7 +363,7 @@ sap.ui.define(
 					oDialogBuilder.hasChildren(
 						OpaBuilder.create()
 							.hasType("sap.m.SegmentedButton")
-							.has(function(oSegmentedButton) {
+							.has(function (oSegmentedButton) {
 								if (sSortOrder === SortOrder.None) {
 									return !oSegmentedButton.enabled;
 								}
@@ -386,7 +382,7 @@ sap.ui.define(
 			sDescription = aArguments[3];
 			return this.prepareResult(
 				oBuilder
-					.success(function() {
+					.success(function () {
 						bDialogOpen = FEBuilder.controlsExist(oDialogBuilder);
 						if (!bDialogOpen) {
 							fnOpenDialog();
@@ -410,7 +406,7 @@ sap.ui.define(
 		 *
 		 * @ui5-restricted
 		 */
-		TableAPI.prototype.columnAdaptation = function(vColumnIdentifier, mState, vActions, sDescription) {
+		TableAPI.prototype.columnAdaptation = function (vColumnIdentifier, mState, vActions, sDescription) {
 			return this.personalization(
 				vColumnIdentifier,
 				mState,
@@ -435,7 +431,7 @@ sap.ui.define(
 		 *
 		 * @ui5-restricted
 		 */
-		TableAPI.prototype.columnSorting = function(vColumnIdentifier, mState, vActions, sDescription) {
+		TableAPI.prototype.columnSorting = function (vColumnIdentifier, mState, vActions, sDescription) {
 			return this.sortingPersonalization(
 				vColumnIdentifier,
 				mState,