@openui5/sap.ui.mdc 1.103.1 → 1.104.0

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

@@ -0,0 +1,50 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/test/actions/EnterText",
+	"sap/ui/test/actions/Press",
+	"./waitForField",
+	"./waitForFieldValueHelpButton"
+], function(
+	Opa5,
+	EnterText,
+	Press,
+	waitForField,
+	waitForFieldValueHelpButton
+) {
+    "use strict";
+
+    return {
+		iEnterTextOnTheField: function(sId, sValue) {
+			return waitForField.call(this, {
+				properties: {
+					id: sId
+				},
+				actions: new EnterText({
+					text: sValue
+				}),
+				success: function(oFilterField) {
+					Opa5.assert.ok(true, 'The text "' + sValue + '" was entered into the field');
+				},
+				errorMessage: 'The text "' + sValue + '" could not be entered into the field'
+			});
+		},
+
+		//TODO
+		iPressOnTheFieldValueHelpButton: function(sId) {
+			return waitForFieldValueHelpButton.call(this, {
+				properties: {
+					id: sId
+				},
+				actions: new Press(),
+				success: function(oValueHelpIconButton) {
+					Opa5.assert.ok(oValueHelpIconButton, "The field value help button was pressed");
+				},
+				errorMessage: "The field value help button could not be press"
+			});
+		}
+	};
+});

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

@@ -0,0 +1,40 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/test/matchers/Ancestor",
+	"sap/base/util/deepEqual",
+	"./waitForField"
+], function(
+	Opa5,
+	Ancestor,
+	deepEqual,
+	waitForField
+) {
+	"use strict";
+
+	return {
+
+		iShouldSeeTheFieldWithValues: function(sId, oValues) {
+			return waitForField.call(this, {
+				properties: {
+					id: sId
+				},
+				check: function(aFields) {
+					var oField = aFields[0];
+					return deepEqual(oField.getValue(), oValues);
+				},
+				success: onFieldWithExpectedValueFound,
+				errorMessage: "The field stores the unexpected value"
+			});
+
+			function onFieldWithExpectedValueFound(oFilterField) {
+				var sMessage = 'The expected value are stored for the field with the id "' + sId + '"';
+				Opa5.assert.ok(true, sMessage);
+			}
+		}
+    };
+});
+

package/test/sap/ui/mdc/testutils/opa/field/JSDoc.md

@@ -0,0 +1,37 @@
+<a name="onTheMDCField"></a>
+
+## onTheMDCField : <code>object</code>
+**Kind**: global namespace  
+
+* [onTheMDCField](#onTheMDCField) : <code>object</code>
+    * [.iEnterTextOnTheField(sId, oValue)](#onTheMDCField.iEnterTextOnTheField) ⇒ <code>Promise</code>
+    * [.iShouldSeeTheFieldWithValues(sId, oValues)](#onTheMDCField.iShouldSeeTheFieldWithValues) ⇒ <code>Promise</code>
+
+<a name="onTheMDCField.iEnterTextOnTheField"></a>
+
+### onTheMDCField.iEnterTextOnTheField(sId, oValue) ⇒ <code>Promise</code>
+Opa5 test action
+
+**Kind**: static method of [<code>onTheMDCField</code>](#onTheMDCField)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+**Access**: public  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| sId | <code>string</code> | ID of the given <code>Field</code> |
+| oValue | <code>Object</code> | Value which is to be entered in the <code>Field</code> |
+
+<a name="onTheMDCField.iShouldSeeTheFieldWithValues"></a>
+
+### onTheMDCField.iShouldSeeTheFieldWithValues(sId, oValues) ⇒ <code>Promise</code>
+Opa5 test assertion
+
+**Kind**: static method of [<code>onTheMDCField</code>](#onTheMDCField)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+**Access**: public  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| sId | <code>string</code> | ID of the given <code>Field</code> |
+| oValues | <code>object</code> | Values which are expected in the <code>Field</code> |
+

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

@@ -0,0 +1,52 @@
+/*!
+ * ${copyright}
+ */
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"./Actions",
+	"./Assertions"
+], function(
+	Opa5,
+	fieldActions,
+	fieldAssertions
+) {
+	"use strict";
+
+	/**
+	 * @namespace onTheMDCField
+	 */
+	Opa5.createPageObjects({
+		onTheMDCField: {
+			actions: {
+				/**
+				 * Opa5 test action
+				 * @memberof onTheMDCField
+				 * @method iEnterTextOnTheField
+				 * @param {string} sId ID of the given <code>Field</code>
+				 * @param {Object} oValue Value which is to be entered in the <code>Field</code>
+				 * @returns {Promise} OPA waitFor
+				 * @public
+				 */
+				iEnterTextOnTheField: function(sId, oValue) {
+					return fieldActions.iEnterTextOnTheField.apply(this, arguments);
+				}
+			},
+			assertions: {
+				/**
+				 * Opa5 test assertion
+				 * @memberof onTheMDCField
+				 * @method iShouldSeeTheFieldWithValues
+				 * @param {string} sId ID of the given <code>Field</code>
+				 * @param {object} oValues Values which are expected in the <code>Field</code>
+				 * @returns {Promise} OPA waitFor
+				 * @public
+				 */
+				iShouldSeeTheFieldWithValues: function(sId, oValues) {
+					return fieldAssertions.iShouldSeeTheFieldWithValues.apply(this, arguments);
+				}
+
+			}
+		}
+	});
+
+});

package/test/sap/ui/mdc/testutils/opa/field/waitForField.js

@@ -0,0 +1,36 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5"
+], function(
+	Opa5
+) {
+	"use strict";
+
+	return function waitForField(oSettings) {
+		oSettings = oSettings || {};
+
+		return this.waitFor({
+			controlType: "sap.ui.mdc.Field",
+			properties: oSettings.properties,
+			matchers: {
+				// ancestor: {
+				// 	controlType: "sap.ui.layout.form.SimpleForm" // "sap.ui.mdc.FilterBar"
+				// }
+			},
+			actions: oSettings.actions,
+			check: oSettings.check,
+			success: function(aFields) {
+				Opa5.assert.strictEqual(aFields.length, 1, "The field was found");
+
+				if (typeof oSettings.success === "function") {
+					var oField = aFields[0];
+					oSettings.success.call(this, oField);
+				}
+			},
+			errorMessage: "The field was not found"
+		});
+	};
+});

package/test/sap/ui/mdc/testutils/opa/field/waitForFieldValueHelpButton.js

@@ -0,0 +1,42 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/test/matchers/Ancestor",
+	"./waitForField"
+], function(
+	Opa5,
+	Ancestor,
+	waitForField
+) {
+	"use strict";
+
+	return function waitForFieldValueHelpButton(oSettings) {
+
+		return waitForField.call(this, {
+			properties: oSettings.properties,
+			success: onFieldFound
+		});
+
+		function onFieldFound(oField) {
+			var sValueHelpButtonID = oField.getId() + "-inner-vhi";
+
+			this.waitFor({
+				id: sValueHelpButtonID,
+				controlType: "sap.ui.core.Icon",
+				matchers: new Ancestor(oField),
+				actions: oSettings.actions,
+				success: function(oValueHelpIconButton) {
+					Opa5.assert.ok(oValueHelpIconButton, "The field value help button was found");
+
+					if (typeof oSettings.success === "function") {
+						oSettings.success.call(this, oValueHelpIconButton);
+					}
+				},
+				errorMessage: "The field value help button could not be found"
+			});
+		}
+	};
+});

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

@@ -7,35 +7,34 @@ sap.ui.define([
 	"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",
 	"./Util",
+	"../Utils",
 	"../p13n/Actions",
 	"../p13n/Util",
 	"../p13n/waitForP13nButtonWithMatchers",
 	"../p13n/waitForP13nDialog",
-	"sap/ui/core/Core"
+	"./waitForAdaptFiltersButton"
 ], function(
 	Opa5,
 	Matcher,
 	Properties,
 	Ancestor,
-	Descendant,
 	PropertyStrictEquals,
 	Press,
 	EnterText,
 	FilterBarUtil,
+	Utils,
 	p13nActions,
 	p13nUtil,
 	waitForP13nButtonWithMatchers,
 	waitForP13nDialog,
-	oCore
+	waitForAdaptFiltersButton
 ) {
 	"use strict";
 
-	var oMDCBundle = oCore.getLibraryResourceBundle("sap.ui.mdc");
 
 	var iEnterFilterValue = function(oGroupViewItem, mSettings) {
 		// Get sap.m.Panel of GroupViewItem
@@ -150,11 +149,11 @@ sap.ui.define([
 					// Add matcher for p13n button text
 					var oMatcher = new Matcher();
 					oMatcher.isMatching = function(oButton) {
-						return oButton.getText().includes(oMDCBundle.getText("filterbar.ADAPT"));
+						return oButton.getText().includes(Utils.getTextFromResourceBundle("sap.ui.mdc", "filterbar.ADAPT"));
 					};
 					aButtonMatchers.push(oMatcher);
 					aDialogMatchers.push(new Properties({
-						title: oMDCBundle.getText("filterbar.ADAPT_TITLE")
+						title: Utils.getTextFromResourceBundle("sap.ui.mdc", "filterbar.ADAPT_TITLE")
 					}));
 
 					waitForP13nButtonWithMatchers.call(this, {
@@ -293,7 +292,32 @@ sap.ui.define([
 					});
 				}
 			});
+		},
+
+		iChangeAdaptFiltersView: function(sViewMode) {
+			return this.waitFor({
+				controlType: "sap.ui.mdc.p13n.panels.AdaptFiltersPanel",
+				matchers: {
+					ancestor: {
+						controlType: "sap.ui.mdc.filterbar.FilterBarBase"
+					}
+				},
+				success:function(aGroupPanelBase) {
+					Opa5.assert.equal(aGroupPanelBase.length, 1, "Adapt Filters Panel found");
+					aGroupPanelBase[0].switchView(sViewMode);
+				}
+			});
+		},
+
+		iPressOnTheAdaptFiltersButton: function() {
+			return waitForAdaptFiltersButton.call(this, {
+				actions: new Press(),
+				success: function onAdaptFiltersButtonFound(oAdaptFiltersButton) {
+					Opa5.assert.ok(true, 'The "Adapt Filters" button was pressed');
+				}
+			});
 		}
+
     };
 
 	return oActions;

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

@@ -7,20 +7,20 @@ sap.ui.define([
 	"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/matchers/PropertyStrictEquals",
+    "./waitForFilterBar",
+    "./waitForAdaptFiltersButton"
 ], function(
 	Opa5,
 	Matcher,
 	Properties,
 	Ancestor,
-	Descendant,
-	PropertyStrictEquals
+	PropertyStrictEquals,
+    waitForFilterBar,
+    waitForAdaptFiltersButton
 ) {
 	"use strict";
 
-	//var oMDCBundle = sap.ui.getCore().getLibraryResourceBundle("sap.ui.mdc");
-
     var iShouldSeeFilterField = function(oFilterBarInstance, sLabel, aExpectedConditions) {
         var vMatchers;
 
@@ -85,7 +85,53 @@ sap.ui.define([
                     }
                 }
             });
-        }
+        },
+
+		iShouldSeeTheFilterBar: function() {
+			return waitForFilterBar.call(this);
+		},
+
+		iShouldSeeTheFilterFieldsWithLabels: function(aLabelNames) {
+
+			function onFilterFieldsFound(aFilterFields) {
+				Opa5.assert.strictEqual(aFilterFields.length, aLabelNames.length, "The exact number of filter fields were found");
+
+				var oFilterBar = aFilterFields[0].getParent(),
+					aFilterFieldsReOrdered = oFilterBar.getFilterItems();
+
+				if (aFilterFieldsReOrdered.length === aLabelNames.length) {
+					aLabelNames.forEach(function(sLabel, iIndex) {
+						var oFilterField = aFilterFieldsReOrdered[iIndex];
+						Opa5.assert.strictEqual(oFilterField.getLabel(), sLabel, 'The filter field labeled as "' + sLabel + '" found');
+					});
+				}
+			}
+
+			return this.waitFor({
+				searchOpenDialogs: false,
+				controlType: "sap.ui.mdc.FilterBar",
+				matchers: {
+					properties: {
+						showAdaptFiltersButton: true
+					}
+				},
+				success: function(aFilterBar){
+					Opa5.assert.strictEqual(aFilterBar.length, 1, "Only one FilterBar is present");
+					this.waitFor({
+						controlType: "sap.ui.mdc.FilterField",
+						matchers: new Ancestor(aFilterBar[0], true),
+						success: function(aFilterFields) {
+							onFilterFieldsFound(aFilterFields);
+						}
+					});
+				},
+				errorMessage: "The filter fields could not be found"
+			});
+		},
+
+		iShouldSeeTheAdaptFiltersButton: function() {
+			return waitForAdaptFiltersButton.call(this);
+		}
     };
 
 });

package/test/sap/ui/mdc/testutils/opa/filterbar/JSDoc.md

@@ -0,0 +1,188 @@
+<a name="onTheMDCFilterBar"></a>
+
+## onTheMDCFilterBar : <code>object</code>
+**Kind**: global namespace  
+
+* [onTheMDCFilterBar](#onTheMDCFilterBar) : <code>object</code>
+    * [.iPersonalizeFilter(oFilterBar, oSettings)](#onTheMDCFilterBar.iPersonalizeFilter) ⇒ <code>Promise</code>
+    * [.iResetThePersonalization(oFilterBar)](#onTheMDCFilterBar.iResetThePersonalization) ⇒ <code>Promise</code>
+    * [.iExpectSearch(oFilterBar)](#onTheMDCFilterBar.iExpectSearch) ⇒ <code>Promise</code>
+    * [.iEnterFilterValue(oFilterBar, mSettings)](#onTheMDCFilterBar.iEnterFilterValue) ⇒ <code>Promise</code>
+    * [.iClearFilterValue(oFilterBar, sFilterLabel)](#onTheMDCFilterBar.iClearFilterValue) ⇒ <code>Promise</code>
+    * [.iPressOnTheAdaptFiltersButton()](#onTheMDCFilterBar.iPressOnTheAdaptFiltersButton) ⇒ <code>Promise</code>
+    * [.iShouldSeeFilters(oFilterBar, vSettings)](#onTheMDCFilterBar.iShouldSeeFilters) ⇒ <code>Promise</code>
+    * [.iShouldSeeTheFilterBar()](#onTheMDCFilterBar.iShouldSeeTheFilterBar) ⇒ <code>Promise</code>
+    * [.iShouldSeeTheFilterFieldsWithLabels(aLabelNames)](#onTheMDCFilterBar.iShouldSeeTheFilterFieldsWithLabels) ⇒ <code>Promise</code>
+    * [.iShouldSeeTheAdaptFiltersButton()](#onTheMDCFilterBar.iShouldSeeTheAdaptFiltersButton) ⇒ <code>Promise</code>
+
+<a name="onTheMDCFilterBar.iPersonalizeFilter"></a>
+
+### onTheMDCFilterBar.iPersonalizeFilter(oFilterBar, oSettings) ⇒ <code>Promise</code>
+OPA5 test action
+<ol>
+	<li>
+		Opens the personalization dialog of the given <code>FilterBar</code>.
+	</li>
+ <li>
+		Navigates to the "Group" tab.
+	</li>
+	<li>
+		Opens all groups and selects / deselects all <code>FilterFields</code> depending on <code>oSettings</code>. Only the labels defined in <code>oSettings</code> will be selected, others will be deselected.
+	</li>
+	<li>
+		Closes the personalization dialog.
+	</li>
+</ol>
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| oFilterBar | <code>sap.ui.core.Control</code> \| <code>string</code> | Instance / ID of the <code>FilterBar</code> that is filtered |
+| oSettings | <code>Object</code> | 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> |
+
+<a name="onTheMDCFilterBar.iResetThePersonalization"></a>
+
+### onTheMDCFilterBar.iResetThePersonalization(oFilterBar) ⇒ <code>Promise</code>
+OPA5 test action
+<ol>
+	<li>
+		Opens the personalization dialog of the given <code>FilterBar</code>.
+	</li>
+	<li>
+		Presses the reset personalization button.
+	</li>
+	<li>
+		Confirms the reset dialog.
+	</li>
+	<li>
+		Closes the personalization dialog.
+	</li>
+</ol>
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| oFilterBar | <code>sap.ui.core.Control</code> \| <code>string</code> | Instance / ID of the <code>FilterBar</code> |
+
+<a name="onTheMDCFilterBar.iExpectSearch"></a>
+
+### onTheMDCFilterBar.iExpectSearch(oFilterBar) ⇒ <code>Promise</code>
+OPA5 test action
+Presses the apply filters button of the <code>FilterBar</code>.
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| oFilterBar | <code>sap.ui.core.Control</code> \| <code>string</code> | Instance / ID of the <code>FilterBar</code> |
+
+<a name="onTheMDCFilterBar.iEnterFilterValue"></a>
+
+### onTheMDCFilterBar.iEnterFilterValue(oFilterBar, mSettings) ⇒ <code>Promise</code>
+OPA5 test action
+<ol>
+	<li>
+		Opens the personalization dialog of the given <code>FilterBar</code>.
+	</li>
+	<li>
+		Navigates to the "Group" tab.
+	</li>
+	<li>
+		Opens the given groups and enters all values in the <code>FilterFields</code> depending on <code>oSettings</code>.
+	</li>
+	<li>
+		Closes the personalization dialog.
+	</li>
+</ol>
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| oFilterBar | <code>sap.ui.core.Control</code> \| <code>string</code> | Instance / ID of the <code>FilterBar</code> |
+| mSettings | <code>Object</code> | 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 |
+
+<a name="onTheMDCFilterBar.iClearFilterValue"></a>
+
+### onTheMDCFilterBar.iClearFilterValue(oFilterBar, sFilterLabel) ⇒ <code>Promise</code>
+OPA5 test action
+Clears all values of a <code>FilterField</code> with a given label on the <code>FilterBar</code>.
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| oFilterBar | <code>sap.ui.core.Control</code> \| <code>string</code> | Instance / ID of the <code>FilterBar</code> |
+| sFilterLabel | <code>string</code> | Label of the <code>FilterField</code> |
+
+<a name="onTheMDCFilterBar.iPressOnTheAdaptFiltersButton"></a>
+
+### onTheMDCFilterBar.iPressOnTheAdaptFiltersButton() ⇒ <code>Promise</code>
+OPA5 test action
+Checks if there is a button visible on the application with the adopt filters icon and presses that given button.
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+<a name="onTheMDCFilterBar.iShouldSeeFilters"></a>
+
+### onTheMDCFilterBar.iShouldSeeFilters(oFilterBar, vSettings) ⇒ <code>Promise</code>
+OPA5 test assertion
+Checks if given <code>FilterFields</code> are displayed on a given <code>FilterBar</code>.
+Depending on the <code>vSettings</code> type this function can be used in two different ways:
+<ul>
+	<li>
+		<code>vSettings</code> is an array of strings:
+		Checks if all given strings are labels for <code>FilterFields</code> on a given <code>FilterBar</code>.
+	</li>
+	<li>
+ 	<code>vSettings</code> is an object:
+		Checks for each key in the object if there is a label for a <code>FilterFields</code> of a given <code>FilterBar</code>.
+		The value of that key is an array containing objects with the operators and values that are expected for the given <code>FilterFields</code>.
+		If the value is an empty array, the given <code>FilterFields</code> doesn't have a value.
+ </li>
+</ul>
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| oFilterBar | <code>sap.ui.core.Control</code> \| <code>string</code> | Instance / ID of the <code>FilterBar</code> |
+| vSettings | <code>Array.&lt;string&gt;</code> \| <code>Object</code> | Settings in which the expected filters are defined |
+
+<a name="onTheMDCFilterBar.iShouldSeeTheFilterBar"></a>
+
+### onTheMDCFilterBar.iShouldSeeTheFilterBar() ⇒ <code>Promise</code>
+OPA5 test assertion
+Checks if there is a <code>FilterBar</code> visible on the application.
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+<a name="onTheMDCFilterBar.iShouldSeeTheFilterFieldsWithLabels"></a>
+
+### onTheMDCFilterBar.iShouldSeeTheFilterFieldsWithLabels(aLabelNames) ⇒ <code>Promise</code>
+OPA5 test assertion
+Checks if there are <code>FilterFields</code> visible on the application with given labels.
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| aLabelNames | <code>Array.&lt;string&gt;</code> | Array containing the labels of the expected <code>FilterFields</code> |
+
+<a name="onTheMDCFilterBar.iShouldSeeTheAdaptFiltersButton"></a>
+
+### onTheMDCFilterBar.iShouldSeeTheAdaptFiltersButton() ⇒ <code>Promise</code>
+OPA5 test assertion
+Checks if there is a button visible on the application with the adopt filters icon.
+
+**Kind**: static method of [<code>onTheMDCFilterBar</code>](#onTheMDCFilterBar)  
+**Returns**: <code>Promise</code> - OPA waitFor