@sap/open.fe 1.94.0

package/packages/sap.fe.test/src/sap/fe/test/api/TableAssertions.js

@@ -0,0 +1,6 @@
+/*
+ * ! SAP UI development toolkit for HTML5 (SAPUI5)
+        (c) Copyright 2009-2021 SAP SE. All rights reserved
+    
+ */
+sap.ui.define(["./TableAPI","sap/fe/test/Utils","sap/ui/test/OpaBuilder","sap/fe/test/builder/FEBuilder","sap/fe/test/builder/MdcTableBuilder","sap/fe/test/builder/MdcFilterFieldBuilder","sap/ui/core/SortOrder","./APIHelper"],function(T,U,O,F,a,b,S,A){"use strict";var c=function(B,t){return T.call(this,B,t);};c.prototype=Object.create(T.prototype);c.prototype.constructor=c;c.prototype.isAction=false;c.prototype.iCheckState=function(s){var t=this.getBuilder();return this.prepareResult(t.hasState(s).description(U.formatMessage("Checking table '{0}' in state '{1}'",this.getIdentifier(),s)).execute());};c.prototype.iCheckRows=function(r,e,s,E){var d=U.parseArguments([Object,Number,Object,Array],arguments),n=d[1],R=T.createRowMatchers(d[0],d[2],undefined,d[3]),t=this.getBuilder();if(R.length){t.hasRows(R,true).has(function(f){return U.isOfType(n,Number)?f.length===n:f.length>0;});}else{t.hasNumberOfRows(n).hasRows(null,true);}return this.prepareResult(t.description(U.formatMessage("Checking table '{0}' having {1} rows with values='{2}', state='{3}' and empty columns='{4}'",this.getIdentifier(),n===undefined?"> 0":n,d[0],d[2],d[3])).execute());};c.prototype.iCheckCreationRow=function(r,s){var t=this.getBuilder();return this.prepareResult(t.has(O.Matchers.childrenMatcher(F.create(this).hasType("sap.ui.table.CreationRow").has(a.Row.Matchers.cellValues(r)).hasState(s))).description(U.formatMessage("Checking table '{0}' having a CreationRow with values='{1}' and state='{2}'",this.getIdentifier(),r,s)).execute());};c.prototype.iCheckQuickFilterItems=function(e){return this.prepareResult(this.getBuilder().hasQuickFilterItems(e).description(U.formatMessage("Checking table '{0}' having  '{1}' item(s)",this.getIdentifier(),e)).execute());};c.prototype.iCheckColumns=function(e,C){var d=U.parseArguments([Number,Object],arguments),m=d[1],n=d[0],t=this.getBuilder();if(n!==undefined){t.hasAggregationLength("columns",n);}else{t.hasAggregation("columns");}t.hasColumns(m);return this.prepareResult(t.description(U.formatMessage("Checking table '{0}' having {1} columns and column states='{2}'",this.getIdentifier(),n===undefined?"> 0":n,m)).execute());};c.prototype.iCheckCells=function(r,C){var R=arguments.length>1?arguments[0]:undefined,m=arguments.length>1?arguments[1]:arguments[0],d=T.createRowMatchers(R,a.Row.Matchers.cellProperties(m)),t=this.getBuilder();return this.prepareResult(t.hasRows(d).description(U.formatMessage("Checking table '{0}' having cells properties '{2}' of rows with values '{1}'",this.getIdentifier(),R,m)).execute());};c.prototype.iCheckAction=function(v,s){var t=this.getBuilder(),d=this.createActionMatcher(v),e=F.Matchers.deepAggregationMatcher("actions/action",[d,F.Matchers.states(s)]);if(s&&s.visible===false){e=O.Matchers.some(e,O.Matchers.not(F.Matchers.deepAggregationMatcher("actions/action",d)));}return this.prepareResult(t.has(e).description(U.formatMessage("Checking table '{0}' having action '{1}' with state='{2}'",this.getIdentifier(),v.service==="StandardAction"?v.action:v,s)).execute());};c.prototype.iCheckMenuAction=function(v){return this.prepareResult(A.createMenuActionCheckBuilder(v).execute());};c.prototype.iCheckDelete=function(s){return this.iCheckAction({service:"StandardAction",action:"Delete",unbound:true},s);};c.prototype.iCheckSearchField=function(s,m){var d=U.parseArguments([String,Object],arguments),t=this.getBuilder();return this.prepareResult(t.hasSearchField(s,m).description(U.formatMessage("Checking the search field on table '{0}' having search text '{1}' and state='{2}'",this.getIdentifier(),d[0]||"",d[1])).execute());};c.prototype.iCheckCreate=function(s){return this.iCheckAction({service:"StandardAction",action:"Create",unbound:true},s);};c.prototype.iCheckPaste=function(s){return this.iCheckAction({service:"StandardAction",action:"Paste",unbound:true},s);};c.prototype.iCheckFullScreen=function(s){return this.iCheckAction({service:"StandardAction",action:"FullScreen",unbound:true},s);};c.prototype._iCheckTableProvidedAction=function(p){var t=this.getBuilder();return this.prepareResult(t["has"+p]().description(U.formatMessage("Checking table '{0}' having button available for '{1}'",this.getIdentifier(),p)).execute());};c.prototype.iCheckColumnAdaptation=function(){return this._iCheckTableProvidedAction("ColumnAdaptation");};c.prototype.iCheckColumnSorting=function(){this.iOpenColumnSorting();a.createSortingDialogBuilder(this.getOpaInstance()).execute();return this.iConfirmColumnSorting();};c.prototype.iCheckColumnFiltering=function(){this.iOpenFilterDialog();a.createFilteringDialogBuilder(this.getOpaInstance()).execute();return this.iConfirmFilterDialog();};c.prototype.iCheckExport=function(){return this._iCheckTableProvidedAction("ColumnExport");};c.prototype.iCheckQuickFilter=function(s){var t=this.getBuilder();return this.prepareResult(t.hasAggregation("quickFilter",F.Matchers.states(s)).description(U.formatMessage("Checking that table '{0}' has a QuickFilter Control with state='{1}'",this.getIdentifier(),s)).execute());};c.prototype.iCheckColumnAdaptationDialog=function(){var o=a.createAdaptationDialogBuilder(this.getOpaInstance());return this.prepareResult(o.description(U.formatMessage("Checking column adaptation dialog for table '{0}'",this.getIdentifier())).execute());};c.prototype.iCheckAdaptationColumn=function(C,s){return this.columnAdaptation(C,s,undefined,U.formatMessage("Checking adaptation column '{1}' on table '{0}' for state='{2}'",this.getIdentifier(),C,s));};c.prototype.iCheckSortOrder=function(C,s,d){var e=U.parseArguments([[String,Object],String,Boolean],arguments);s=e[1]||S.Ascending;d=e[2];var D=U.formatMessage("Checking column '{1}' on table '{0}' to be sorted '{2}'",this.getIdentifier(),C,s);if(d){var m={};m.sortOrder=s;return this.columnSorting(C,m,undefined,D);}var f={};f[U.isOfType(C,Object)?C.name:C]={sortOrder:s};return this.prepareResult(this.getBuilder().hasColumns(f).description(D).execute());};c.prototype.iCheckFilterField=function(C,s){var f=b.create(this.getOpaInstance()).isDialogElement().hasType("sap.ui.mdc.FilterField").description(U.formatMessage("Checking the filter field '{0}' of table '{1}' in state '{2}'",C,this.getIdentifier(),s)),o=U.isOfType(C,String)?O.Matchers.properties({label:C}):O.Matchers.properties({fieldPath:C.name}),d,e=s&&s.visible===false,g=this.iOpenFilterDialog.bind(this),h=this.iConfirmFilterDialog.bind(this);if(e){f.check(function(i){return i.every(function(j){return O.Matchers.not(o)(j);});});}else{f.has(o).checkNumberOfMatches(1);if(!U.isOfType(s,[null,undefined])){f.hasState(s);}}return this.prepareResult(F.create(this.getOpaInstance()).success(function(){d=F.controlsExist(f);if(!d){g();f.success(h);}return f.execute();}).execute());};c.prototype.iCheckMessageStrip=function(p){var t=this.getBuilder();return this.prepareResult(t.has(O.Matchers.childrenMatcher(F.create(this).hasType("sap.m.MessageStrip").hasProperties(p))).description(U.formatMessage("Checking table '{0}' having a MessageStrip with text ='{1}' and type ='{2}'",this.getIdentifier(),p.text,p.type)).execute());};c.prototype.iCheckGroupByColumn=function(C,e,f){var t=this.getBuilder(),v=U.isOfType(C,Object)?C.name:C;return this.prepareResult(t.hasGroupByColumn(v,f,e).description(U.formatMessage("Checking table '{0}' having {1} groupBy options for {2}{3}",this.getIdentifier(),e===undefined?"any":e,C,f?"/"+f:"")).execute());};c.prototype.iCheckAggregationColumn=function(C,e,f){var t=this.getBuilder(),v=U.isOfType(C,Object)?C.name:C;return this.prepareResult(t.hasAggregationColumn(v,f,e).description(U.formatMessage("Checking table '{0}' having {1} aggregate options for {2}{3}",this.getIdentifier(),e===undefined?"any":e,C,f?"/"+f:"")).execute());};return c;});

package/packages/sap.fe.test/src/sap/fe/test/builder/DialogBuilder-dbg.js

@@ -0,0 +1,118 @@
+/*
+ * ! SAP UI development toolkit for HTML5 (SAPUI5)
+        (c) Copyright 2009-2021 SAP SE. All rights reserved
+    
+ */
+sap.ui.define(["./FEBuilder", "./OverflowToolbarBuilder", "sap/ui/test/OpaBuilder", "sap/fe/test/Utils"], function(
+	FEBuilder,
+	OverflowToolbarBuilder,
+	OpaBuilder,
+	Utils
+) {
+	"use strict";
+
+	// additionally, picking the dialog with the highest z-index (which is increased by UI5 internally) in success function
+	function getMostUpperDialog(aDialogs) {
+		return (
+			Array.isArray(aDialogs) &&
+			aDialogs
+				.sort(function(oDialogA, oDialogB) {
+					return Number.parseInt(oDialogA.$().css("z-index"), 10) - Number.parseInt(oDialogB.$().css("z-index"), 10);
+				})
+				.pop()
+		);
+	}
+
+	var DialogBuilder = function() {
+		var oDialogFinder = FEBuilder.create()
+			.isDialogElement()
+			.hasType("sap.m.Dialog");
+		return FEBuilder.apply(this, arguments)
+			.options(oDialogFinder.build())
+			.has(function(oDialog) {
+				return getMostUpperDialog(FEBuilder.getControls(oDialogFinder)) === oDialog;
+			});
+	};
+
+	DialogBuilder.create = function(oOpaInstance, oOptions) {
+		return new DialogBuilder(oOpaInstance, oOptions);
+	};
+
+	DialogBuilder.prototype = Object.create(FEBuilder.prototype);
+	DialogBuilder.prototype.constructor = DialogBuilder;
+
+	DialogBuilder.prototype.hasContent = function(vContentMatcher, bReturnContent) {
+		this.has(
+			bReturnContent
+				? OpaBuilder.Matchers.aggregation("content", vContentMatcher)
+				: OpaBuilder.Matchers.aggregationMatcher("content", vContentMatcher)
+		);
+		if (bReturnContent) {
+			return this.has(FEBuilder.Matchers.atIndex(0));
+		}
+		return this;
+	};
+
+	DialogBuilder.prototype.hasHeaderButton = function(vButtonMatcher, mState) {
+		return this.has(OpaBuilder.Matchers.aggregation("customHeader"))
+			.has(FEBuilder.Matchers.atIndex(0))
+			.hasSome(
+				OpaBuilder.Matchers.aggregation("contentLeft", vButtonMatcher),
+				OpaBuilder.Matchers.aggregation("contentMiddle", vButtonMatcher),
+				OpaBuilder.Matchers.aggregation("contentRight", vButtonMatcher)
+			)
+			.has(FEBuilder.Matchers.atIndex(0))
+			.hasState(mState);
+	};
+
+	DialogBuilder.prototype.hasFooterButton = function(vButtonMatcher, mState) {
+		return this.doOpenFooterOverflow().success(function(vDialog) {
+			if (Array.isArray(vDialog)) {
+				if (vDialog.length !== 1) {
+					throw new Error(Utils.formatMessage("no single dialog found: {0}", vDialog));
+				}
+				vDialog = vDialog[0];
+			}
+			return FEBuilder.create()
+				.hasId(vDialog.getId())
+				.has(OpaBuilder.Matchers.aggregation("buttons", vButtonMatcher))
+				.has(FEBuilder.Matchers.atIndex(0))
+				.hasState(mState)
+				.execute();
+		});
+	};
+
+	DialogBuilder.prototype.doPressHeaderButton = function(vButtonMatcher) {
+		return this.has(OpaBuilder.Matchers.aggregation("customHeader"))
+			.has(FEBuilder.Matchers.atIndex(0))
+			.hasSome(
+				OpaBuilder.Matchers.aggregation("contentLeft", vButtonMatcher),
+				OpaBuilder.Matchers.aggregation("contentMiddle", vButtonMatcher),
+				OpaBuilder.Matchers.aggregation("contentRight", vButtonMatcher)
+			)
+			.has(FEBuilder.Matchers.atIndex(0))
+			.doPress();
+	};
+
+	DialogBuilder.prototype.doOpenFooterOverflow = function() {
+		return OverflowToolbarBuilder.openOverflow(this, "footer");
+	};
+
+	DialogBuilder.prototype.doPressFooterButton = function(vButtonMatcher) {
+		return this.doOpenFooterOverflow().success(function(vDialog) {
+			if (Array.isArray(vDialog)) {
+				if (vDialog.length !== 1) {
+					throw new Error(Utils.formatMessage("no single dialog found: {0}", vDialog));
+				}
+				vDialog = vDialog[0];
+			}
+			return OpaBuilder.create()
+				.hasId(vDialog.getId())
+				.has(OpaBuilder.Matchers.aggregation("buttons", vButtonMatcher))
+				.doPress()
+				.execute();
+		});
+	};
+
+	return DialogBuilder;
+});

package/packages/sap.fe.test/src/sap/fe/test/builder/DialogBuilder.js

@@ -0,0 +1,6 @@
+/*
+ * ! SAP UI development toolkit for HTML5 (SAPUI5)
+        (c) Copyright 2009-2021 SAP SE. All rights reserved
+    
+ */
+sap.ui.define(["./FEBuilder","./OverflowToolbarBuilder","sap/ui/test/OpaBuilder","sap/fe/test/Utils"],function(F,O,a,U){"use strict";function g(d){return(Array.isArray(d)&&d.sort(function(o,b){return Number.parseInt(o.$().css("z-index"),10)-Number.parseInt(b.$().css("z-index"),10);}).pop());}var D=function(){var d=F.create().isDialogElement().hasType("sap.m.Dialog");return F.apply(this,arguments).options(d.build()).has(function(o){return g(F.getControls(d))===o;});};D.create=function(o,b){return new D(o,b);};D.prototype=Object.create(F.prototype);D.prototype.constructor=D;D.prototype.hasContent=function(c,r){this.has(r?a.Matchers.aggregation("content",c):a.Matchers.aggregationMatcher("content",c));if(r){return this.has(F.Matchers.atIndex(0));}return this;};D.prototype.hasHeaderButton=function(b,s){return this.has(a.Matchers.aggregation("customHeader")).has(F.Matchers.atIndex(0)).hasSome(a.Matchers.aggregation("contentLeft",b),a.Matchers.aggregation("contentMiddle",b),a.Matchers.aggregation("contentRight",b)).has(F.Matchers.atIndex(0)).hasState(s);};D.prototype.hasFooterButton=function(b,s){return this.doOpenFooterOverflow().success(function(d){if(Array.isArray(d)){if(d.length!==1){throw new Error(U.formatMessage("no single dialog found: {0}",d));}d=d[0];}return F.create().hasId(d.getId()).has(a.Matchers.aggregation("buttons",b)).has(F.Matchers.atIndex(0)).hasState(s).execute();});};D.prototype.doPressHeaderButton=function(b){return this.has(a.Matchers.aggregation("customHeader")).has(F.Matchers.atIndex(0)).hasSome(a.Matchers.aggregation("contentLeft",b),a.Matchers.aggregation("contentMiddle",b),a.Matchers.aggregation("contentRight",b)).has(F.Matchers.atIndex(0)).doPress();};D.prototype.doOpenFooterOverflow=function(){return O.openOverflow(this,"footer");};D.prototype.doPressFooterButton=function(b){return this.doOpenFooterOverflow().success(function(d){if(Array.isArray(d)){if(d.length!==1){throw new Error(U.formatMessage("no single dialog found: {0}",d));}d=d[0];}return a.create().hasId(d.getId()).has(a.Matchers.aggregation("buttons",b)).doPress().execute();});};return D;});

package/packages/sap.fe.test/src/sap/fe/test/builder/FEBuilder-dbg.js

@@ -0,0 +1,428 @@
+/*
+ * ! SAP UI development toolkit for HTML5 (SAPUI5)
+        (c) Copyright 2009-2021 SAP SE. All rights reserved
+    
+ */
+sap.ui.define(
+	[
+		"sap/ui/test/OpaBuilder",
+		"sap/fe/test/Utils",
+		"sap/ui/test/Opa5",
+		"sap/ui/test/matchers/Matcher",
+		"sap/ui/core/util/ShortcutHelper",
+		"sap/base/util/deepEqual"
+	],
+	function(OpaBuilder, Utils, Opa5, Matcher, ShortcutHelper, deepEqual) {
+		"use strict";
+
+		var ElementStates = {
+			focused: function(bFocused) {
+				var fnFocusedMatcher = OpaBuilder.Matchers.focused(true);
+				return bFocused ? fnFocusedMatcher : OpaBuilder.Matchers.not(fnFocusedMatcher);
+			},
+			controlType: function(vType) {
+				return function(oControl) {
+					return oControl && oControl.isA(vType);
+				};
+			},
+			content: function(mState) {
+				return function(oControl) {
+					if (!oControl) {
+						return false;
+					}
+					var sAggregationName = oControl.getMetadata().getDefaultAggregationName() || "content",
+						vAggControls = Utils.getAggregation(oControl, sAggregationName);
+					if (!vAggControls) {
+						return false;
+					}
+					if (!Array.isArray(vAggControls)) {
+						vAggControls = [vAggControls];
+					}
+					return vAggControls.some(function(oAggControl) {
+						return FEBuilder.Matchers.states(mState)(oAggControl);
+					});
+				};
+			},
+			p13nMode: function(aMode) {
+				if (!Array.isArray(aMode)) {
+					aMode = [];
+				}
+				aMode.sort();
+				return function(oControl) {
+					var p13nMode = oControl.getP13nMode();
+					if (!Array.isArray(p13nMode)) {
+						p13nMode = [];
+					}
+					p13nMode.sort();
+					return deepEqual(aMode, p13nMode);
+				};
+			},
+			label: function(sLabel) {
+				return function(oControl) {
+					if (oControl.getMetadata().getProperty("label")) {
+						return OpaBuilder.Matchers.match(OpaBuilder.Matchers.properties({ label: sLabel }))(oControl);
+					}
+					return FEBuilder.Matchers.label(sLabel)(oControl);
+				};
+			}
+		};
+
+		var FEBuilder = function() {
+			return OpaBuilder.apply(this, arguments);
+		};
+
+		FEBuilder.create = function(oOpaInstance) {
+			return new FEBuilder(oOpaInstance);
+		};
+
+		FEBuilder.prototype = Object.create(OpaBuilder.prototype);
+		FEBuilder.prototype.constructor = FEBuilder;
+
+		/**
+		 * Returns the matcher for states, which might be control specific. This function is meant to be overridden
+		 * by concrete control builder if necessary.
+		 * @param mState
+		 * @returns {Function} The state matcher function
+		 *
+		 * @protected
+		 */
+		FEBuilder.prototype.getStatesMatcher = function(mState) {
+			return FEBuilder.Matchers.states(mState);
+		};
+
+		FEBuilder.prototype.hasState = function(mState) {
+			if (!mState) {
+				return this;
+			}
+			// check explicitly for boolean 'false', falsy value does not suffice
+			if (mState.visible === false) {
+				this.mustBeVisible(false);
+				this.mustBeEnabled(false);
+			}
+			if (mState.enabled === false) {
+				this.mustBeEnabled(false);
+			}
+			return this.has(this.getStatesMatcher(mState));
+		};
+
+		FEBuilder.prototype.doPressKeyboardShortcut = function(sShortcut) {
+			return this.do(FEBuilder.Actions.keyboardShortcut(sShortcut));
+		};
+
+		// overrides the base implementation to support operating on "deep" aggregation, e.g. "content/items" or "actions/action"
+		FEBuilder.prototype.doOnAggregation = function(sAggregationName, vMatchers, vActions) {
+			if (arguments.length < 3) {
+				vActions = vMatchers;
+				vMatchers = undefined;
+			}
+			var fnDeepAggregation = FEBuilder.Matchers.deepAggregation(sAggregationName, vMatchers);
+			return this.do(function(oControl) {
+				OpaBuilder.Actions.executor(vActions)(fnDeepAggregation(oControl));
+			});
+		};
+
+		FEBuilder.getControls = function(vBuilder, bSingle) {
+			var oOptions = vBuilder.build(),
+				vControls = Opa5.getPlugin().getMatchingControls(oOptions),
+				aControls = OpaBuilder.Matchers.filter(oOptions.matchers)(vControls);
+			if (bSingle) {
+				if (aControls.length > 1) {
+					throw new Error("found ambiguous results");
+				}
+				return aControls.length ? aControls[0] : null;
+			}
+			return aControls;
+		};
+
+		FEBuilder.controlsExist = function(vBuilder) {
+			return !!FEBuilder.getControls(vBuilder).length;
+		};
+
+		FEBuilder.createClosePopoverBuilder = function(oOpaInstance, vPopoverMatchers, bStrict) {
+			return OpaBuilder.create(oOpaInstance).success(function() {
+				var bPopoverClosed = false,
+					fnCloseCallback = function() {
+						bPopoverClosed = true;
+					},
+					oBuilder = FEBuilder.createPopoverBuilder(oOpaInstance, vPopoverMatchers);
+
+				if (bStrict || FEBuilder.controlsExist(oBuilder)) {
+					return oBuilder
+						.do(function(oPopover) {
+							oPopover.attachEventOnce("afterClose", fnCloseCallback);
+							oPopover.close();
+						})
+						.success(
+							OpaBuilder.create(oOpaInstance).check(function() {
+								return bPopoverClosed;
+							})
+						)
+						.execute();
+				}
+			});
+		};
+
+		FEBuilder.createPopoverBuilder = function(oOpaInstance, vPopoverMatchers) {
+			var oBuilder = OpaBuilder.create(oOpaInstance)
+				.hasType("sap.m.Popover")
+				.isDialogElement(true)
+				.has(function(oPopover) {
+					return oPopover.isOpen();
+				})
+				.checkNumberOfMatches(1);
+
+			if (vPopoverMatchers) {
+				oBuilder.has(vPopoverMatchers || []);
+			}
+
+			return oBuilder;
+		};
+
+		FEBuilder.createMessageToastBuilder = function(sText) {
+			return OpaBuilder.create()
+				.check(function() {
+					var oWindow = Opa5.getWindow();
+					return (
+						oWindow.sapFEStubs && oWindow.sapFEStubs.getLastToastMessage && oWindow.sapFEStubs.getLastToastMessage() === sText
+					);
+				})
+				.description("Toast message '" + sText + "' was displayed");
+		};
+
+		FEBuilder.Matchers = {
+			FOCUSED_ELEMENT: function() {
+				var oTestCore = Opa5.getWindow().sap.ui.getCore(),
+					sFocusedId = oTestCore.getCurrentFocusedControlId();
+				if (sFocusedId) {
+					return oTestCore.byId(sFocusedId);
+				}
+				return null;
+			},
+			state: function(sName, vValue) {
+				if (sName in ElementStates) {
+					return ElementStates[sName](vValue);
+				}
+				return function(oControl) {
+					// check whether an aggregation exists with given name...
+					var oMetadata = oControl.getMetadata(),
+						vAggControls =
+							oMetadata.hasAggregation(sName) && oMetadata.getAggregation(sName).multiple
+								? Utils.getAggregation(oControl, sName)
+								: null;
+					// ...if not, use normal properties matcher
+					if (!vAggControls) {
+						var mProperties = {};
+						mProperties[sName] = vValue;
+						return FEBuilder.Matchers.match(OpaBuilder.Matchers.properties(mProperties))(oControl);
+					}
+					if (!Array.isArray(vAggControls)) {
+						vAggControls = [vAggControls];
+					}
+					if (!Array.isArray(vValue)) {
+						// implicit check for aggregation length if number is given after an aggregation name
+						if (Utils.isOfType(vValue, Number)) {
+							return vAggControls.length === vValue;
+						}
+						return vAggControls.some(function(oAggControl) {
+							return FEBuilder.Matchers.states(vValue)(oAggControl);
+						});
+					}
+					// at this point we have both vAggControls and vValue as arrays => we check each single element against its corresponding state
+					return (
+						vValue.length === vAggControls.length &&
+						vAggControls.every(function(oAggControl, iIndex) {
+							return FEBuilder.Matchers.states(vValue[iIndex])(oAggControl);
+						})
+					);
+				};
+			},
+			states: function(mStateMap, fnSingleStateMatcher) {
+				if (!Utils.isOfType(mStateMap, Object)) {
+					return OpaBuilder.Matchers.TRUE;
+				}
+				if (!Utils.isOfType(fnSingleStateMatcher, Function)) {
+					fnSingleStateMatcher = FEBuilder.Matchers.state;
+				}
+				return FEBuilder.Matchers.match(
+					Object.keys(mStateMap).map(function(sProperty) {
+						return fnSingleStateMatcher(sProperty, mStateMap[sProperty]);
+					})
+				);
+			},
+			match: function(vMatchers) {
+				var fnMatch = OpaBuilder.Matchers.match(vMatchers);
+				return function(oControl) {
+					// ensure that the result is a boolean
+					return !!fnMatch(oControl);
+				};
+			},
+			bound: function() {
+				return function(oControl) {
+					return oControl && !!oControl.getBindingContext();
+				};
+			},
+			allMatch: function(vMatchers) {
+				var fnFilterMatcher = OpaBuilder.Matchers.filter(vMatchers);
+				return function(aItems) {
+					var iExpectedLength = (aItems && aItems.length) || 0;
+					return iExpectedLength === fnFilterMatcher(aItems).length;
+				};
+			},
+			someMatch: function(vMatchers) {
+				var fnFilterMatcher = OpaBuilder.Matchers.filter(vMatchers);
+				return function(aItems) {
+					return fnFilterMatcher(aItems).length > 0;
+				};
+			},
+			/**
+			 * Creates a matcher function that is identifying a control by id.
+			 * The result will be true in case of the string was found, otherwise false.
+			 *
+			 * @param {string|RegExp} vId The string/RegExp to be used for identifying the control
+			 * @returns {Function} The matcher function returning true/false
+			 * @public
+			 * @static
+			 */
+			id: function(vId) {
+				return function(oControl) {
+					if (Utils.isOfType(vId, String)) {
+						return oControl.getId() === vId;
+					} else {
+						return vId.test(oControl.getId());
+					}
+				};
+			},
+			/**
+			 * Creates a matcher function that is identifying a control by type.
+			 * The result will be true in case of the string was found, otherwise false.
+			 *
+			 * @param {string|RegExp} vType The string/RegExp to be used for identifying the control
+			 * @returns {Function} The matcher function returning true/false
+			 * @public
+			 * @static
+			 */
+			type: function(vType) {
+				return function(oControl) {
+					if (Utils.isOfType(vType, String)) {
+						return oControl.getMetadata().getName() === vType;
+					} else {
+						return vType.test(oControl.getMetadata().getName());
+					}
+				};
+			},
+			/**
+			 * Creates a matcher that returns the element at <code>iIndex</code> from input array.
+			 *
+			 * @param {number} iIndex The index of the element to be returned
+			 * @returns {Function} The matcher function returning element at given index
+			 */
+			atIndex: function(iIndex) {
+				return function(vInput) {
+					if (Utils.isOfType(vInput, [null, undefined])) {
+						return null;
+					}
+					vInput = [].concat(vInput);
+					return vInput.length > iIndex ? vInput[iIndex] : null;
+				};
+			},
+
+			singleElement: function() {
+				return function(vControls) {
+					if (!Array.isArray(vControls)) {
+						vControls = [vControls];
+					}
+					if (vControls.length !== 1) {
+						return false;
+					}
+					return vControls[0];
+				};
+			},
+
+			label: function(sText) {
+				// either Label control exists having labelFor target the control, or ariaLabelledBy is available on control
+				return OpaBuilder.Matchers.some(
+					// alternative implementation to sap.ui.test.matchers.LabelFor, which does not support labels for links
+					function(vControl) {
+						var sControlId = vControl.getId && vControl.getId();
+						return (
+							sControlId &&
+							FEBuilder.controlsExist(
+								FEBuilder.create()
+									.hasType("sap.m.Label")
+									.hasProperties({ text: sText, labelFor: sControlId })
+							)
+						);
+					},
+					function(vControl) {
+						var aAriaLabelledBy = vControl.getAriaLabelledBy && vControl.getAriaLabelledBy();
+						if (Array.isArray(aAriaLabelledBy) && aAriaLabelledBy.length > 0) {
+							return aAriaLabelledBy.some(function(sAriaLabelledById) {
+								var oAriaLabelledBy = Opa5.getWindow()
+									.sap.ui.getCore()
+									.byId(sAriaLabelledById);
+								return oAriaLabelledBy && oAriaLabelledBy.getText && oAriaLabelledBy.getText() === sText;
+							});
+						}
+					}
+				);
+			},
+			/**
+			 * Supports an aggregation path to deeper aggregations like "actions/action" or "content/items/control".
+			 *
+			 * @param {string} sAggregationPath The aggregation path
+			 * @param {any} [vMatchers] Matchers against target controls
+			 * @returns {function(*): *} A matcher function that returns always an array with matching controls
+			 */
+			deepAggregation: function(sAggregationPath, vMatchers) {
+				var fnFilter = OpaBuilder.Matchers.filter(vMatchers),
+					fnMapControlToAggregationName = function(oControl) {
+						return Utils.getAggregation(oControl, this);
+					};
+				return function(oControl) {
+					var aAggregationNames = sAggregationPath.split("/"),
+						aTargetControls = aAggregationNames.reduce(
+							function(aCurrentControls, sAggregationName) {
+								return Array.prototype.concat.apply(
+									[],
+									aCurrentControls.map(fnMapControlToAggregationName.bind(sAggregationName))
+								);
+							},
+							[oControl]
+						);
+					return fnFilter(aTargetControls);
+				};
+			},
+
+			deepAggregationMatcher: function(sAggregationPath, vMatchers) {
+				var fnDeepAggregation = FEBuilder.Matchers.deepAggregation(sAggregationPath, vMatchers);
+				return function(oControl) {
+					return fnDeepAggregation(oControl).length > 0;
+				};
+			}
+		};
+
+		FEBuilder.Actions = {
+			keyboardShortcut: function(sShortcut, sChildElement, bIgnoreFocus) {
+				var aArguments = Utils.parseArguments([String, String, Boolean], arguments);
+				sShortcut = aArguments[0];
+				sChildElement = aArguments[1];
+				bIgnoreFocus = aArguments[2];
+				return function(oElement) {
+					var oNormalizedShortCut = ShortcutHelper.parseShortcut(sShortcut);
+					oNormalizedShortCut.type = "keydown";
+					// do not lower-case single key definitions (e.g. Enter, Space, ...), else the event might not be triggered properly
+					if (sShortcut.toLowerCase() === oNormalizedShortCut.key) {
+						oNormalizedShortCut.key = sShortcut;
+					}
+					var oJqueryElement = sChildElement ? oElement.$().find(sChildElement) : oElement.$();
+					if (!bIgnoreFocus) {
+						oElement.focus();
+					}
+					oJqueryElement.trigger(oNormalizedShortCut);
+				};
+			}
+		};
+
+		return FEBuilder;
+	}
+);

package/packages/sap.fe.test/src/sap/fe/test/builder/FEBuilder.js

@@ -0,0 +1,6 @@
+/*
+ * ! SAP UI development toolkit for HTML5 (SAPUI5)
+        (c) Copyright 2009-2021 SAP SE. All rights reserved
+    
+ */
+sap.ui.define(["sap/ui/test/OpaBuilder","sap/fe/test/Utils","sap/ui/test/Opa5","sap/ui/test/matchers/Matcher","sap/ui/core/util/ShortcutHelper","sap/base/util/deepEqual"],function(O,U,a,M,S,d){"use strict";var E={focused:function(f){var b=O.Matchers.focused(true);return f?b:O.Matchers.not(b);},controlType:function(t){return function(c){return c&&c.isA(t);};},content:function(s){return function(c){if(!c){return false;}var A=c.getMetadata().getDefaultAggregationName()||"content",v=U.getAggregation(c,A);if(!v){return false;}if(!Array.isArray(v)){v=[v];}return v.some(function(o){return F.Matchers.states(s)(o);});};},p13nMode:function(m){if(!Array.isArray(m)){m=[];}m.sort();return function(c){var p=c.getP13nMode();if(!Array.isArray(p)){p=[];}p.sort();return d(m,p);};},label:function(l){return function(c){if(c.getMetadata().getProperty("label")){return O.Matchers.match(O.Matchers.properties({label:l}))(c);}return F.Matchers.label(l)(c);};}};var F=function(){return O.apply(this,arguments);};F.create=function(o){return new F(o);};F.prototype=Object.create(O.prototype);F.prototype.constructor=F;F.prototype.getStatesMatcher=function(s){return F.Matchers.states(s);};F.prototype.hasState=function(s){if(!s){return this;}if(s.visible===false){this.mustBeVisible(false);this.mustBeEnabled(false);}if(s.enabled===false){this.mustBeEnabled(false);}return this.has(this.getStatesMatcher(s));};F.prototype.doPressKeyboardShortcut=function(s){return this.do(F.Actions.keyboardShortcut(s));};F.prototype.doOnAggregation=function(A,m,v){if(arguments.length<3){v=m;m=undefined;}var D=F.Matchers.deepAggregation(A,m);return this.do(function(c){O.Actions.executor(v)(D(c));});};F.getControls=function(b,s){var o=b.build(),c=a.getPlugin().getMatchingControls(o),C=O.Matchers.filter(o.matchers)(c);if(s){if(C.length>1){throw new Error("found ambiguous results");}return C.length?C[0]:null;}return C;};F.controlsExist=function(b){return!!F.getControls(b).length;};F.createClosePopoverBuilder=function(o,p,s){return O.create(o).success(function(){var P=false,c=function(){P=true;},b=F.createPopoverBuilder(o,p);if(s||F.controlsExist(b)){return b.do(function(e){e.attachEventOnce("afterClose",c);e.close();}).success(O.create(o).check(function(){return P;})).execute();}});};F.createPopoverBuilder=function(o,p){var b=O.create(o).hasType("sap.m.Popover").isDialogElement(true).has(function(P){return P.isOpen();}).checkNumberOfMatches(1);if(p){b.has(p||[]);}return b;};F.createMessageToastBuilder=function(t){return O.create().check(function(){var w=a.getWindow();return(w.sapFEStubs&&w.sapFEStubs.getLastToastMessage&&w.sapFEStubs.getLastToastMessage()===t);}).description("Toast message '"+t+"' was displayed");};F.Matchers={FOCUSED_ELEMENT:function(){var t=a.getWindow().sap.ui.getCore(),f=t.getCurrentFocusedControlId();if(f){return t.byId(f);}return null;},state:function(n,v){if(n in E){return E[n](v);}return function(c){var m=c.getMetadata(),A=m.hasAggregation(n)&&m.getAggregation(n).multiple?U.getAggregation(c,n):null;if(!A){var p={};p[n]=v;return F.Matchers.match(O.Matchers.properties(p))(c);}if(!Array.isArray(A)){A=[A];}if(!Array.isArray(v)){if(U.isOfType(v,Number)){return A.length===v;}return A.some(function(o){return F.Matchers.states(v)(o);});}return(v.length===A.length&&A.every(function(o,i){return F.Matchers.states(v[i])(o);}));};},states:function(s,f){if(!U.isOfType(s,Object)){return O.Matchers.TRUE;}if(!U.isOfType(f,Function)){f=F.Matchers.state;}return F.Matchers.match(Object.keys(s).map(function(p){return f(p,s[p]);}));},match:function(m){var f=O.Matchers.match(m);return function(c){return!!f(c);};},bound:function(){return function(c){return c&&!!c.getBindingContext();};},allMatch:function(m){var f=O.Matchers.filter(m);return function(i){var e=(i&&i.length)||0;return e===f(i).length;};},someMatch:function(m){var f=O.Matchers.filter(m);return function(i){return f(i).length>0;};},id:function(i){return function(c){if(U.isOfType(i,String)){return c.getId()===i;}else{return i.test(c.getId());}};},type:function(t){return function(c){if(U.isOfType(t,String)){return c.getMetadata().getName()===t;}else{return t.test(c.getMetadata().getName());}};},atIndex:function(i){return function(I){if(U.isOfType(I,[null,undefined])){return null;}I=[].concat(I);return I.length>i?I[i]:null;};},singleElement:function(){return function(c){if(!Array.isArray(c)){c=[c];}if(c.length!==1){return false;}return c[0];};},label:function(t){return O.Matchers.some(function(c){var C=c.getId&&c.getId();return(C&&F.controlsExist(F.create().hasType("sap.m.Label").hasProperties({text:t,labelFor:C})));},function(c){var A=c.getAriaLabelledBy&&c.getAriaLabelledBy();if(Array.isArray(A)&&A.length>0){return A.some(function(s){var o=a.getWindow().sap.ui.getCore().byId(s);return o&&o.getText&&o.getText()===t;});}});},deepAggregation:function(A,m){var f=O.Matchers.filter(m),b=function(c){return U.getAggregation(c,this);};return function(c){var e=A.split("/"),t=e.reduce(function(C,s){return Array.prototype.concat.apply([],C.map(b.bind(s)));},[c]);return f(t);};},deepAggregationMatcher:function(A,m){var D=F.Matchers.deepAggregation(A,m);return function(c){return D(c).length>0;};}};F.Actions={keyboardShortcut:function(s,c,i){var A=U.parseArguments([String,String,Boolean],arguments);s=A[0];c=A[1];i=A[2];return function(e){var n=S.parseShortcut(s);n.type="keydown";if(s.toLowerCase()===n.key){n.key=s;}var j=c?e.$().find(c):e.$();if(!i){e.focus();}j.trigger(n);};}};return F;});

package/packages/sap.fe.test/src/sap/fe/test/builder/KPIBuilder-dbg.js

@@ -0,0 +1,56 @@
+/*
+ * ! SAP UI development toolkit for HTML5 (SAPUI5)
+        (c) Copyright 2009-2021 SAP SE. All rights reserved
+    
+ */
+sap.ui.define(["./FEBuilder", "sap/ui/test/OpaBuilder", "sap/fe/test/Utils"], function(FEBuilder, OpaBuilder, Utils) {
+	"use strict";
+
+	var KPIBuilder = function() {
+		return FEBuilder.apply(this, arguments);
+	};
+
+	KPIBuilder.create = function(oOpaInstance) {
+		return new KPIBuilder(oOpaInstance);
+	};
+
+	KPIBuilder.prototype = Object.create(FEBuilder.prototype);
+	KPIBuilder.prototype.constructor = KPIBuilder;
+
+	/**
+	 * Checks if a KPI exists with a given label and other optional properties.
+	 *
+	 * @param {string} sKPILabel The label of the new variant
+	 * @param {object} oKPIProperties Additional optional properties on the KPI (status, number, or unit)
+	 * @returns {sap.fe.test.builder.KPIBuilder} This instance
+	 * @public
+	 * @ui5-restricted
+	 */
+	KPIBuilder.prototype.checkKPI = function(sKPILabel, oKPIProperties) {
+		var oTagProperties = { text: sKPILabel };
+
+		if (oKPIProperties && oKPIProperties.status) {
+			oTagProperties.status = oKPIProperties.status;
+		}
+
+		var retValue = this.hasType("sap.m.GenericTag").hasProperties(oTagProperties);
+
+		if (oKPIProperties && (oKPIProperties.number || oKPIProperties.unit)) {
+			var oNumberProperties = {};
+			if (oKPIProperties.number) {
+				oNumberProperties.number = oKPIProperties.number;
+			}
+			if (oKPIProperties.unit) {
+				oNumberProperties.unit = oKPIProperties.unit;
+			}
+			retValue = retValue.hasChildren(
+				FEBuilder.create(this)
+					.hasType("sap.m.ObjectNumber")
+					.hasProperties(oNumberProperties)
+			);
+		}
+		return retValue;
+	};
+
+	return KPIBuilder;
+});

package/packages/sap.fe.test/src/sap/fe/test/builder/KPIBuilder.js

@@ -0,0 +1,6 @@
+/*
+ * ! SAP UI development toolkit for HTML5 (SAPUI5)
+        (c) Copyright 2009-2021 SAP SE. All rights reserved
+    
+ */
+sap.ui.define(["./FEBuilder","sap/ui/test/OpaBuilder","sap/fe/test/Utils"],function(F,O,U){"use strict";var K=function(){return F.apply(this,arguments);};K.create=function(o){return new K(o);};K.prototype=Object.create(F.prototype);K.prototype.constructor=K;K.prototype.checkKPI=function(k,o){var t={text:k};if(o&&o.status){t.status=o.status;}var r=this.hasType("sap.m.GenericTag").hasProperties(t);if(o&&(o.number||o.unit)){var n={};if(o.number){n.number=o.number;}if(o.unit){n.unit=o.unit;}r=r.hasChildren(F.create(this).hasType("sap.m.ObjectNumber").hasProperties(n));}return r;};return K;});