@openui5/sap.ui.core 1.121.1 → 1.122.1

package/src/sap/ui/core/util/XMLPreprocessor.js

@@ -42,7 +42,7 @@ sap.ui.define([
 		 */
 		With = ManagedObject.extend("sap.ui.core.util._with", {
 			metadata : {
-				library: "sap.ui.core",
+				library : "sap.ui.core",
 				properties : {
 					any : "any"
 				},
@@ -61,7 +61,7 @@ sap.ui.define([
 		 */
 		Repeat = With.extend("sap.ui.core.util._repeat", {
 			metadata : {
-				library: "sap.ui.core",
+				library : "sap.ui.core",
 				aggregations : {
 					list : {multiple : true, type : "n/a", _doesNotRequireFactory : true}
 				}
@@ -134,6 +134,7 @@ sap.ui.define([
 					oBindingOrContext.getPath(), oBindingOrContext.getContext());
 		}
 
+		// eslint-disable-next-line no-warning-comments
 		/**
 		 * Context interface provided by XML template processing as an additional first argument to
 		 * any formatter function which opts in to this mechanism. Candidates for such formatter
@@ -275,7 +276,7 @@ sap.ui.define([
 
 				if (sPath) {
 					oModel = oBindingOrContext.getModel();
-					if (sPath.charAt(0) !==  '/') { // relative path needs a base context
+					if (sPath.charAt(0) !== "/") { // relative path needs a base context
 						oBaseContext = oBindingOrContext instanceof Context
 							? oBindingOrContext
 							: oModel.createBindingContext(oBindingOrContext.getPath(),
@@ -305,6 +306,7 @@ sap.ui.define([
 			 */
 			getModel : function (iPart) {
 				var oBindingOrContext = getBindingOrContext(iPart);
+
 				return oBindingOrContext && oBindingOrContext.getModel();
 			},
 
@@ -321,6 +323,7 @@ sap.ui.define([
 			 */
 			getPath : function (iPart) {
 				var oBindingOrContext = getBindingOrContext(iPart);
+
 				return oBindingOrContext && getPath(oBindingOrContext);
 			},
 
@@ -391,6 +394,7 @@ sap.ui.define([
 					&& (oModel && oModel.$$valueAsPromise || i === undefined && bValueAsPromise)) {
 				oInfo.formatter = function () {
 					var that = this;
+
 					return SyncPromise.all(arguments).then(function (aArguments) {
 						return fnFormatter.apply(that, aArguments);
 					});
@@ -445,7 +449,7 @@ sap.ui.define([
 		 *
 		 * @param {boolean} bFound
 		 *   Whether an element was approved by the corresponding callback
-		 * @returns {sap.ui.base.SyncPromise|any}
+		 * @returns {sap.ui.base.SyncPromise|any|undefined}
 		 *   First call returns a <code>sap.ui.base.SyncPromise</code> which resolves with a later
 		 *   call's result.
 		 */
@@ -457,6 +461,7 @@ sap.ui.define([
 			if (i < aElements.length) {
 				return fnCallback(aElements[i], i, aElements).then(next);
 			}
+			return undefined;
 		}
 
 		return aElements.length
@@ -910,7 +915,7 @@ sap.ui.define([
 					 * @see sap.ui.core.util.XMLPreprocessor.ICallback.getResult
 					 * @since 1.39.0
 					 */
-					"with" : function (mVariables, bReplace) {
+					with : function (mVariables, bReplace) {
 						var oContext,
 							bHasVariables = false,
 							sName,
@@ -982,7 +987,7 @@ sap.ui.define([
 			 *   the XML DOM element
 			 */
 			function error(sMessage, oElement) {
-				sMessage = sMessage + serializeSingleElement(oElement);
+				sMessage += serializeSingleElement(oElement);
 				Log.error(sMessage, sCaller, sXMLPreprocessor);
 				throw new Error(sCaller + ": " + sMessage);
 			}
@@ -1131,8 +1136,8 @@ sap.ui.define([
 
 					if (vBindingInfo.functionsNotFound) {
 						if (bMandatory) {
-							warn(oElement, 'Function name(s)',
-								vBindingInfo.functionsNotFound.join(", "), 'not found');
+							warn(oElement, "Function name(s)",
+								vBindingInfo.functionsNotFound.join(", "), "not found");
 						}
 						return null; // treat incomplete bindings as unrelated
 					}
@@ -1147,6 +1152,12 @@ sap.ui.define([
 						return null;
 					}
 
+					const bStaticOnly
+						= vBindingInfo.parts.every((oPart) => oPart.value !== undefined);
+					if (bStaticOnly) {
+						fnCallIfConstant?.();
+					}
+
 					if (!oTypesPromise) {
 						const oPromise = getAny(oWithControl, vBindingInfo, mSettings, oScope,
 							!oViewInfo.sync);
@@ -1267,14 +1278,14 @@ sap.ui.define([
 			 */
 			function performTest(oElement, oWithControl) {
 				// constant test conditions are suspicious, but useful during development
-				var fnCallIfConstant = warn.bind(null, oElement, 'Constant test condition'),
+				var fnCallIfConstant = warn.bind(null, oElement, "Constant test condition"),
 					oPromise
 						= getResolvedBinding(oElement.getAttribute("test"), oElement, oWithControl,
 								true, fnCallIfConstant)
 						|| SyncPromise.resolve(false);
 
 				return oPromise.catch(function (ex) {
-					warn(oElement, 'Error in formatter:', ex);
+					warn(oElement, "Error in formatter:", ex);
 					// "test == undefined --> false" in debug log
 				}).then(function (vTest) {
 					var bResult = !!vTest && vTest !== "false";
@@ -1383,7 +1394,7 @@ sap.ui.define([
 				var oPromise = getResolvedBinding(oAttribute.value, oElement, oWithControl, false);
 
 				if (!oPromise) {
-					debug(oElement, 'Binding not ready for attribute', oAttribute.name);
+					debug(oElement, "Binding not ready for attribute", oAttribute.name);
 					return oSyncPromiseResolved;
 				}
 				return oPromise.then(function (vValue) {
@@ -1496,7 +1507,7 @@ sap.ui.define([
 
 					return true;
 				}, function (ex) {
-					warn(oElement, 'Error in formatter:', ex);
+					warn(oElement, "Error in formatter:", ex);
 					return true;
 				});
 			}
@@ -1528,7 +1539,7 @@ sap.ui.define([
 						oScope = oOldScope;
 					});
 				}, function (ex) {
-					warn(oElement, 'Error in formatter:', ex);
+					warn(oElement, "Error in formatter:", ex);
 				});
 			}
 
@@ -1599,8 +1610,8 @@ sap.ui.define([
 					error("Missing binding for ", oElement);
 				}
 				if (oBindingInfo.functionsNotFound) {
-					warn(oElement, 'Function name(s)', oBindingInfo.functionsNotFound.join(", "),
-						'not found');
+					warn(oElement, "Function name(s)", oBindingInfo.functionsNotFound.join(", "),
+						"not found");
 				}
 
 				// set up a scope for the loop variable, so to say
@@ -1748,7 +1759,7 @@ sap.ui.define([
 						// Warn and ignore the new "with" control when its binding context is
 						// the same as a previous one.
 						// We test identity because models cache and reuse binding contexts.
-						warn(oElement, 'Set unchanged path:', sResolvedPath);
+						warn(oElement, "Set unchanged path:", sResolvedPath);
 						oNewWithControl = oWithControl;
 					}
 
@@ -1774,12 +1785,24 @@ sap.ui.define([
 			 */
 			function visitAttribute(oElement, oAttribute, oWithControl) {
 				if (fnSupportInfo) {
-					fnSupportInfo({context:undefined /*context from node clone*/, env:{caller:"visitAttribute", before: {name: oAttribute.name, value: oAttribute.value}}});
+					fnSupportInfo({
+						context : undefined /*context from node clone*/,
+						env : {
+							caller : "visitAttribute",
+							before : {name : oAttribute.name, value : oAttribute.value}
+						}
+					});
 				}
 				return resolveAttributeBinding(oElement, oAttribute, oWithControl)
 					.then(function () {
 						if (fnSupportInfo) {
-							fnSupportInfo({context:undefined /*context from node clone*/, env:{caller:"visitAttribute", after: {name: oAttribute.name, value: oAttribute.value}}});
+							fnSupportInfo({
+								context : undefined /*context from node clone*/,
+								env : {
+									caller : "visitAttribute",
+									after : {name : oAttribute.name, value : oAttribute.value}
+								}
+							});
 						}
 					});
 			}
@@ -1853,7 +1876,8 @@ sap.ui.define([
 						return visitChildNodes(oNode, oWithControl);
 					}).then(function () {
 						if (fnSupportInfo) {
-							fnSupportInfo({context:oNode, env:{caller:"visitNode", after: {name: oNode.tagName}}});
+							fnSupportInfo({context : oNode,
+								env : {caller : "visitNode", after : {name : oNode.tagName}}});
 						}
 					});
 				}
@@ -1863,7 +1887,8 @@ sap.ui.define([
 					return oSyncPromiseResolved;
 				}
 				if (fnSupportInfo) {
-					fnSupportInfo({context:oNode, env:{caller:"visitNode", before: {name: oNode.tagName}}});
+					fnSupportInfo({context : oNode,
+						env : {caller : "visitNode", before : {name : oNode.tagName}}});
 				}
 				if (oNode.namespaceURI === sNAMESPACE) {
 					switch (oNode.localName) {
@@ -1886,9 +1911,7 @@ sap.ui.define([
 					switch (oNode.localName) {
 					case "ExtensionPoint":
 						return templateExtensionPoint(oNode, oWithControl).then(function (bResult) {
-							if (bResult) {
-								return visitAttributesAndChildren();
-							}
+							return bResult ? visitAttributesAndChildren() : undefined;
 						});
 
 					case "Fragment":
@@ -1959,13 +1982,14 @@ sap.ui.define([
 			}
 			if (fnSupportInfo) {
 				fnSupportInfo({
-						context: oRootElement,
-						env: {
-							caller:"view",
-							viewinfo: deepExtend({}, oViewInfo),
-							settings: deepExtend({}, mSettings),
-							clone: oRootElement.cloneNode(true),
-							type: "template"}
+						context : oRootElement,
+						env : {
+							caller : "view",
+							viewinfo : deepExtend({}, oViewInfo),
+							settings : deepExtend({}, mSettings),
+							clone : oRootElement.cloneNode(true),
+							type : "template"
+						}
 					});
 			}
 			return requireFor(oRootElement).then(function () {

package/src/sap/ui/core/util/_LocalizationHelper.js

@@ -88,6 +88,7 @@ sap.ui.define([
 			}
 			// notify Elements via a pseudo browser event (onLocalizationChanged)
 			if (oObject.isA("sap.ui.core.Element")) {
+				oBrowserEvent._bNoReturnValue = true; // localizationChanged handler aren't allowed to return any value, mark for future fatal throw.
 				oObject._handleEvent(oBrowserEvent);
 			}
 		}
@@ -128,4 +129,4 @@ sap.ui.define([
 	};
 
 	return _LocalizationHelper;
-});
+});

package/src/sap/ui/core/util/reflection/BaseTreeModifier.js

@@ -985,35 +985,6 @@ sap.ui.define([
 			return mDelegateInfo;
 		},
 
-		/**
-		 * Attaches event on the specified <code>ManagedObject</code>.
-		 * To not rely on globals the function has to be passed in addition to the path.
-		 *
-		 * @abstract
-		 * @param {sap.ui.base.ManagedObject|Element} vControl - Control representation
-		 * @param {string} sEventName - Event name
-		 * @param {string} sFunctionPath - Absolute path to a function
-		 * @param {object} vData - Predefined values for event handler function
-		 * @param {function} fnCallback - Callback function that is located at the function path
-		 * @returns {Promise} Resolves when async processing is done
-		 * @public
-		 */
-		attachEvent: function(vControl, sEventName, sFunctionPath, vData, fnCallback) {},
-
-		/**
-		 * Detaches event from the specified ManagedObject.
-		 * To not rely on globals the function has to be passed in addition to the path.
-		 *
-		 * @abstract
-		 * @param {sap.ui.base.ManagedObject|Element} vControl - Control representation
-		 * @param {string} sEventName - Event name
-		 * @param {string} sFunctionPath - Absolute path to a function
-		 * @param {function} fnCallback - Callback function that is located at the function path
-		 * @returns {Promise} Resolves when async processing is done
-		 * @public
-		 */
-		detachEvent: function(vControl, sEventName, sFunctionPath, fnCallback) {},
-
 		/**
 		 * Returns an object containing parent control, aggregation name and index for controls to be added of the given extension point.
 		 *

package/src/sap/ui/core/util/reflection/JsControlTreeModifier.js

@@ -567,32 +567,6 @@ sap.ui.define([
 			return ObjectPath.get(["sap.ui.fl", sType], oCustomData);
 		},
 
-		/**
-		 * @inheritDoc
-		 */
-		attachEvent: function (oObject, sEventName, sFunctionPath, vData, fnCallback) {
-			return new Promise(function (fnResolve, fnReject) {
-				if (typeof fnCallback !== "function") {
-					fnReject(new Error("Can't attach event: fnCallback parameter missing or not a function"));
-				}
-				fnResolve(oObject.attachEvent(sEventName, vData, fnCallback));
-			});
-		},
-
-		/**
-		 * @inheritDoc
-		 */
-		detachEvent: function (oObject, sEventName, sFunctionPath, fnCallback) {
-			return new Promise(function (fnResolve, fnReject) {
-				if (typeof fnCallback !== "function") {
-					fnReject(new Error("Can't detach event: fnCallback parameter missing or not a function"));
-				}
-				// EventProvider.detachEvent doesn't accept vData parameter, therefore it might lead
-				// to a situation when an incorrect event listener is detached.
-				fnResolve(oObject.detachEvent(sEventName, fnCallback));
-			});
-		},
-
 		/**
 		 * @inheritDoc
 		 */

package/src/sap/ui/core/util/reflection/XmlTreeModifier.js

@@ -849,62 +849,6 @@ sap.ui.define([
 			return oControl.getAttributeNS("sap.ui.fl", sType);
 		},
 
-		/**
-		 * @inheritDoc
-		 */
-		attachEvent: function(oNode, sEventName, sFunctionPath, vData, fnCallback) {
-			if (typeof fnCallback !== "function") {
-				return Promise.reject(new Error("Can't attach event: fnCallback parameter missing or not a function"));
-			}
-			return XmlTreeModifier.getProperty(oNode, sEventName)
-				.then(function (sValue) {
-					sValue = sValue || "";
-					var aEventHandlers = EventHandlerResolver.parse(sValue);
-					var sEventHandler = sFunctionPath;
-					var aParams = ["$event"];
-
-					if (vData) {
-						aParams.push(JSON.stringify(vData));
-					}
-
-					sEventHandler += "(" + aParams.join(",") + ")";
-
-					if (!aEventHandlers.includes(sEventHandler)) {
-						aEventHandlers.push(sEventHandler);
-					}
-
-					oNode.setAttribute(sEventName, aEventHandlers.join(";"));
-				});
-		},
-
-		/**
-		 * @inheritDoc
-		 */
-		detachEvent: function(oNode, sEventName, sFunctionPath, fnCallback) {
-			if (typeof fnCallback !== "function") {
-				return Promise.reject(new Error("Can't detach event: fnCallback parameter missing or not a function"));
-			}
-			return XmlTreeModifier.getProperty(oNode, sEventName)
-				.then(function (sValue) {
-					sValue = sValue || "";
-					var aEventHandlers = EventHandlerResolver.parse(sValue);
-
-					var iEventHandlerIndex =  aEventHandlers.findIndex(function (sEventHandler) {
-						return sEventHandler.includes(sFunctionPath);
-					});
-
-					if (iEventHandlerIndex > -1) {
-						aEventHandlers.splice(iEventHandlerIndex, 1);
-					}
-
-					if (aEventHandlers.length) {
-						oNode.setAttribute(sEventName, aEventHandlers.join(";"));
-					} else {
-						oNode.removeAttribute(sEventName);
-					}
-				});
-		},
-
 		/**
 		 * @inheritDoc
 		 */

package/src/sap/ui/core/util/serializer/HTMLViewSerializer.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/base/EventProvider', './Serializer', './delegate/HTML', '
 	 * @class HTMLViewSerializer class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.util.serializer.HTMLViewSerializer
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/Serializer.js

@@ -21,7 +21,7 @@ sap.ui.define(['sap/ui/base/EventProvider', "sap/base/assert"],
 	 * @class Serializer class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.util.serializer.Serializer
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/ViewSerializer.js

@@ -21,7 +21,7 @@ sap.ui.define(['sap/ui/base/EventProvider', './HTMLViewSerializer', './XMLViewSe
 	 * @class ViewSerializer class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.util.serializer.ViewSerializer
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/XMLViewSerializer.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/base/EventProvider', './Serializer', './delegate/XML', 's
 	 * @class XMLViewSerializer class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.util.serializer.XMLViewSerializer
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/delegate/Delegate.js

@@ -17,7 +17,7 @@ sap.ui.define(['sap/ui/base/EventProvider'],
 	 * @class Abstract serializer delegate class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.util.serializer.delegate.Delegate
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/delegate/HTML.js

@@ -19,7 +19,7 @@ sap.ui.define(['./Delegate', "sap/base/strings/hyphenate", "sap/base/util/deepEq
 	 * @class HTML serializer delegate class.
 	 * @extends sap.ui.core.util.serializer.delegate.Delegate
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.util.serializer.delegate.HTML
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/delegate/XML.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @class XML serializer delegate class.
 	 * @extends sap.ui.core.util.serializer.delegate.Delegate
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.util.serializer.delegate.XML
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/webc/WebComponent.js

@@ -108,7 +108,7 @@ function(
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @since 1.118.0
 	 * @alias sap.ui.core.webc.WebComponent

package/src/sap/ui/core/webc/WebComponentMetadata.js

@@ -23,7 +23,7 @@ function(ElementMetadata, WebComponentRenderer, camelize) {
 	 *
 	 * @class
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @since 1.118.0
 	 * @experimental Since 1.118.0 The API might change. It is not intended for productive usage yet!
 	 * @alias sap.ui.core.webc.WebComponentMetadata

package/src/sap/ui/core/ws/ReadyState.js

@@ -12,7 +12,7 @@ sap.ui.define(function() {
 	/**
 	 * Defines the different ready states for a WebSocket connection.
 	 *
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @enum {int}
 	 * @public
 	 * @alias sap.ui.core.ws.ReadyState

package/src/sap/ui/core/ws/SapPcpWebSocket.js

@@ -21,7 +21,7 @@ sap.ui.define(['./WebSocket', "sap/base/Log"],
 	 * @class WebSocket class implementing the pcp-protocol.
 	 * @extends sap.ui.core.ws.WebSocket
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.ws.SapPcpWebSocket
 	 */
 	var SapPcpWebSocket = WebSocket.extend("sap.ui.core.ws.SapPcpWebSocket", /** @lends sap.ui.core.ws.SapPcpWebSocket.prototype */ {

package/src/sap/ui/core/ws/WebSocket.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @class Basic WebSocket class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.ws.WebSocket
 	 */
 	var WebSocket = EventProvider.extend("sap.ui.core.ws.WebSocket", /** @lends sap.ui.core.ws.WebSocket.prototype */ {

package/src/sap/ui/debug/ControlTree.js

@@ -34,7 +34,7 @@ sap.ui.define('sap/ui/debug/ControlTree', [
 	 * @class Control Tree used for the Debug Environment
 	 * @extends sap.ui.base.EventProvider
 	 * @author Martin Schaus, Frank Weigel
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.debug.ControlTree
 	 * @private
 	 */

package/src/sap/ui/debug/DebugEnv.js

@@ -37,7 +37,7 @@ sap.ui.define('sap/ui/debug/DebugEnv', [
 	 * @class Central Class for the Debug Environment
 	 *
 	 * @author Martin Schaus, Frank Weigel
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @private
 	 * @alias sap.ui.debug.DebugEnv
 	 * @deprecated As of Version 1.120

package/src/sap/ui/debug/PropertyList.js

@@ -32,7 +32,7 @@ sap.ui.define('sap/ui/debug/PropertyList', [
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author Martin Schaus
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @param {sap.ui.core.Core}
 	 *            oCore Core instance of the app; version might differ!

package/src/sap/ui/model/ClientListBinding.js

@@ -27,8 +27,11 @@ sap.ui.define([
 	 * @param {sap.ui.model.Model} oModel Model instance that this binding is created for and that it belongs to
 	 * @param {string} sPath Binding path to be used for this binding, syntax depends on the concrete subclass
 	 * @param {sap.ui.model.Context} oContext Binding context relative to which a relative binding path will be resolved
-	 * @param {sap.ui.model.Sorter|sap.ui.model.Sorter[]} [aSorters] Initial sort order (can be either a sorter or an array of sorters)
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} [aFilters] Predefined filter/s (can be either a filter or an array of filters)
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link #sort} to replace them
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter} to
+	 *   replace them
 	 * @param {object} [mParameters] Map of optional parameters as defined by subclasses; this class does not introduce any own parameters
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in <code>aFilters</code>
@@ -320,10 +323,14 @@ sap.ui.define([
 	 * When no <code>sFilterType</code> is given, any previously configured application
 	 * filters are cleared and the given filters are used as control filters
 	 *
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} aFilters Single filter object or an array of filter objects
-	 * @param {sap.ui.model.FilterType} [sFilterType=undefined] Type of the filter which should
-	 *  be adjusted; if no type is given, then any previously configured application filters are
-	 *  cleared and the given filters are used as control filters
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to use; in case of type {@link sap.ui.model.FilterType.Application} this replaces the filters given
+	 *   in {@link sap.ui.model.ClientModel#bindList}; a falsy value is treated as an empty array and thus removes all
+	 *   filters of the specified type
+	 * @param {sap.ui.model.FilterType} [sFilterType]
+	 *   The type of the filter to replace; if no type is given, all filters previously configured with type
+	 *   {@link sap.ui.model.FilterType.Application} are cleared, and the given filters are used as filters of type
+	 *   {@link sap.ui.model.FilterType.Control}
 	 * @returns {this} returns <code>this</code> to facilitate method chaining
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in

package/src/sap/ui/model/ClientModel.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.Model
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @param {string} [oData] URL where to load the data from
 	 * @public

package/src/sap/ui/model/ClientTreeBinding.js

@@ -24,9 +24,12 @@ sap.ui.define([
 	 * @param {sap.ui.model.Model} oModel Model instance that this binding is created for and that it belongs to
 	 * @param {string} sPath Binding path pointing to the tree / array that should be bound; syntax is defined by subclasses
 	 * @param {sap.ui.model.Context} [oContext=null] Context object for this binding, mandatory when when a relative binding path is given
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} [aApplicationFilters=null] Predefined application filter, either a single instance or an array
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aApplicationFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter} to
+	 *   replace them
 	 * @param {object} [mParameters=null] Additional model specific parameters as defined by subclasses; this class does not introduce any own parameters
-	 * @param {sap.ui.model.Sorter[]} [aSorters=null] Predefined sorter/s contained in an array (optional)
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link #sort} to replace them
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in
 	 *   <code>aApplicationFilters</code> together with other filters
@@ -264,10 +267,14 @@ sap.ui.define([
 	 * results of all groups are ANDed.
 	 *
 	 * @see sap.ui.model.TreeBinding.prototype.filter
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} aFilters Single filter object or an array of filter objects
-	 * @param {sap.ui.model.FilterType} [sFilterType] Type of the filter to be adjusted; if no type
-	 *   is given, any previously configured application filters are cleared, and the given filters
-	 *   are used as control filters
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to use; in case of type {@link sap.ui.model.FilterType.Application} this replaces the filters given
+	 *   in {@link sap.ui.model.ClientModel#bindTree}; a falsy value is treated as an empty array and thus removes all
+	 *   filters of the specified type
+	 * @param {sap.ui.model.FilterType} [sFilterType]
+	 *   The type of the filter to replace; if no type is given, all filters previously configured with type
+	 *   {@link sap.ui.model.FilterType.Application} are cleared, and the given filters are used as filters of type
+	 *   {@link sap.ui.model.FilterType.Control}
 	 * @return {this} <code>this</code> to facilitate method chaining
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in
@@ -380,7 +387,9 @@ sap.ui.define([
 	 * The tree will be sorted level by level. So the nodes are NOT sorted absolute, but relative to
 	 * their parent node, to keep the hierarchy untouched.
 	 *
-	 * @param {sap.ui.model.Sorter[]} aSorters An array of Sorter instances which will be applied
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters to use; they replace the sorters given in {@link sap.ui.model.ClientModel#bindTree}; a falsy value
+	 *   is treated as an empty array and thus removes all sorters
 	 *
 	 * @return {this} Returns <code>this</code> to facilitate method chaining
 	 * @public