@openui5/sap.ui.core 1.121.1 → 1.122.1

package/src/sap/base/util/restricted/_uniqBy.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_uniqBy
  * @author SAP SE
  * @since 1.71
- * @version 1.121.1
+ * @version 1.122.1
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_uniqWith.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_uniqWith
  * @author SAP SE
  * @since 1.71
- * @version 1.121.1
+ * @version 1.122.1
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_without.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_without
  * @author SAP SE
  * @since 1.80
- * @version 1.121.1
+ * @version 1.122.1
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_xor.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_xor
  * @author SAP SE
  * @since 1.80
- * @version 1.121.1
+ * @version 1.122.1
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_xorBy.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_xorBy
  * @author SAP SE
  * @since 1.80
- * @version 1.121.1
+ * @version 1.122.1
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_xorWith.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_xorWith
  * @author SAP SE
  * @since 1.80
- * @version 1.121.1
+ * @version 1.122.1
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_zipObject.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_zipObject
  * @author SAP SE
  * @since 1.81
- * @version 1.121.1
+ * @version 1.122.1
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_zipObjectDeep.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_zipObjectDeep
  * @author SAP SE
  * @since 1.81
- * @version 1.121.1
+ * @version 1.122.1
  * @private
  * @ui5-restricted
 */

package/src/sap/ui/Device.js

@@ -11,7 +11,7 @@
  * This API is independent from any other part of the UI5 framework. This allows it to be loaded beforehand, if it is needed, to create the UI5 bootstrap
  * dynamically depending on the capabilities of the browser or device.
  *
- * @version 1.121.1
+ * @version 1.122.1
  * @namespace
  * @name sap.ui.Device
  * @public
@@ -32,7 +32,7 @@ if (typeof window.sap.ui !== "object") {
 
 	//Skip initialization if API is already available
 	if (typeof window.sap.ui.Device === "object" || typeof window.sap.ui.Device === "function") {
-		var apiVersion = "1.121.1";
+		var apiVersion = "1.122.1";
 		window.sap.ui.Device._checkAPIVersion(apiVersion);
 		return;
 	}
@@ -105,7 +105,7 @@ if (typeof window.sap.ui !== "object") {
 
 	//Only used internal to make clear when Device API is loaded in wrong version
 	Device._checkAPIVersion = function(sVersion) {
-		var v = "1.121.1";
+		var v = "1.122.1";
 		if (v != sVersion) {
 			oLogger.log(WARNING, "Device API version differs: " + v + " <-> " + sVersion);
 		}

package/src/sap/ui/Global.js

@@ -18,7 +18,7 @@
  * sap.ui.lazyRequire("sap.ui.core.Control");
  * sap.ui.lazyRequire("sap.m.Button");
  *
- * @version 1.121.1
+ * @version 1.122.1
  * @author  SAP SE
  * @public
  */
@@ -48,7 +48,7 @@ sap.ui.define([
 	 * The <code>sap</code> namespace is automatically registered with the
 	 * OpenAjax hub if it exists.
 	 *
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @namespace
 	 * @public
 	 * @name sap
@@ -58,7 +58,7 @@ sap.ui.define([
 	 * The <code>sap.ui</code> namespace is the central OpenAjax compliant entry
 	 * point for UI related JavaScript functionality provided by SAP.
 	 *
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @namespace
 	 * @name sap.ui
 	 * @public
@@ -69,7 +69,7 @@ sap.ui.define([
 		 * The version of the SAP UI Library
 		 * @type string
 		 */
-		version: "1.121.1",
+		version: "1.122.1",
 		// buildinfo.lastchange is deprecated and is therefore defaulted to empty string
 		buildinfo : { lastchange : "", buildtime : "${buildtime}" }
 	};

package/src/sap/ui/base/Event.js

@@ -23,7 +23,7 @@ sap.ui.define(['./Object', "sap/base/assert"],
 	 * @extends sap.ui.base.Object
 	 * @implements sap.ui.base.Poolable
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.base.Event
 	 * @public
 	 * @template {Object<string,any>} [ParamsType=object]

package/src/sap/ui/base/EventProvider.js

@@ -5,8 +5,8 @@
  */
 
 // Provides class sap.ui.base.EventProvider
-sap.ui.define(['./Event', './Object', "sap/base/assert"],
-	function(Event, BaseObject, assert) {
+sap.ui.define(['./Event', './Object', "sap/base/assert", "sap/base/Log"],
+	function(Event, BaseObject, assert, Log) {
 	"use strict";
 
 
@@ -18,7 +18,7 @@ sap.ui.define(['./Event', './Object', "sap/base/assert"],
 	 * @abstract
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @alias sap.ui.base.EventProvider
 	 */
@@ -238,7 +238,13 @@ sap.ui.define(['./Event', './Object', "sap/base/assert"],
 
 				for (i = 0, iL = aEventListeners.length; i < iL; i++) {
 					oInfo = aEventListeners[i];
-					oInfo.fFunction.call(oInfo.oListener || oProvider, oEvent, oInfo.oData);
+					const vResult = oInfo.fFunction.call(oInfo.oListener || oProvider, oEvent, oInfo.oData);
+					// proper error handling for rejected promises
+					if (typeof vResult?.then === "function") {
+						vResult.catch?.((err) => {
+							Log.error(`EventProvider.fireEvent: Event Listener for event '${sEventId}' failed during execution.`, err);
+						});
+					}
 				}
 
 				bEnableEventBubbling = bEnableEventBubbling && !oEvent.bCancelBubble;
@@ -368,4 +374,4 @@ sap.ui.define(['./Event', './Object', "sap/base/assert"],
 
 
 	return EventProvider;
-});
+});

package/src/sap/ui/base/Exception.js

@@ -4,7 +4,7 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
-// Provides a filter for list bindings
+// Provides a base exception class
 sap.ui.define(function() {
 	"use strict";
 

package/src/sap/ui/base/Interface.js

@@ -28,7 +28,7 @@ sap.ui.define(['sap/ui/base/Object'], function(BaseObject) {
 	 * no internals of the class can be accessed.
 	 *
 	 * @author Malte Wedel, Daniel Brinkmann
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @param {sap.ui.base.Object} oObject
 	 *   Object for which a facade should be created
 	 * @param {string[]} aMethods

package/src/sap/ui/base/ManagedObject.js

@@ -12,6 +12,7 @@ sap.ui.define([
 	"./Object",
 	"./BindingInfo",
 	"sap/ui/util/ActivityDetection",
+	"sap/ui/util/_enforceNoReturnValue",
 	"sap/base/future",
 	"sap/base/util/ObjectPath",
 	"sap/base/Log",
@@ -28,6 +29,7 @@ sap.ui.define([
 	BaseObject,
 	BindingInfo,
 	ActivityDetection,
+	_enforceNoReturnValue,
 	future,
 	ObjectPath,
 	Log,
@@ -262,7 +264,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @alias sap.ui.base.ManagedObject
 	 */
@@ -528,7 +530,7 @@ sap.ui.define([
 
 					// Call init method here instead of specific Controls constructor.
 					if (that.init) {
-						that.init();
+						_enforceNoReturnValue(that.init(), /*mLogInfo=*/{ name: "init", component: that.getId()}); // 'init' hook isn't allowed to return any values.
 					}
 
 					// apply the settings
@@ -3009,7 +3011,7 @@ sap.ui.define([
 		}
 
 		if (this.exit) {
-			this.exit();
+			_enforceNoReturnValue(this.exit(), /*mLogInfo=*/{ name: "exit", component: this.getId() }); // 'exit' hook isn't allowed to return any values.
 		}
 
 		// TODO: generic concept for exit hooks?
@@ -3597,6 +3599,23 @@ sap.ui.define([
 
 	ManagedObject.prototype._unbindProperty = logError.bind(null, "_unbindProperty");
 
+	/**
+	 * Find out whether the given property is being updated. This occurs when the corresponding data in the model for
+	 * the given property is changed. The method can be used to determine if the setter of a property is called
+	 * from a model update.
+	 *
+	 * When the given property isn't bound at all, <code>false</code> is returned.
+	 *
+	 * @param {string} sName the name of the property
+	 * @return {boolean} Whether the given property is being updated
+	 * @private
+	 * @ui5-restricted sap.m
+	 */
+	ManagedObject.prototype.isPropertyBeingUpdated = function(sName) {
+		const oBindingInfo = this.getBindingInfo(sName);
+		return !!(oBindingInfo?.skipModelUpdate);
+	};
+
 	/**
 	 * Generic method which is called, whenever a property binding is changed.
 	 *

package/src/sap/ui/base/ManagedObjectMetadata.js

@@ -79,7 +79,7 @@ function(
 	 *
 	 *
 	 * @author Frank Weigel
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @since 0.8.6
 	 * @alias sap.ui.base.ManagedObjectMetadata
 	 * @extends sap.ui.base.Metadata

package/src/sap/ui/base/Metadata.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 *
 	 * @class Metadata for a class.
 	 * @author Frank Weigel
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @since 0.8.6
 	 * @public
 	 * @alias sap.ui.base.Metadata

package/src/sap/ui/base/Object.js

@@ -26,7 +26,7 @@ sap.ui.define(['./Metadata', "sap/base/Log"],
 	 * @class Base class for all SAPUI5 Objects.
 	 * @abstract
 	 * @author Malte Wedel
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @alias sap.ui.base.Object
 	 * @throws {Error} When an instance of the class or its subclasses is created without the <code>new</code> operator.

package/src/sap/ui/base/ObjectPool.js

@@ -59,7 +59,7 @@ sap.ui.define(['./Object'],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.base.ObjectPool
 	 * @public
 	 */

package/src/sap/ui/core/.library

@@ -6,7 +6,7 @@
   <copyright>OpenUI5
  * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-  <version>1.121.1</version>
+  <version>1.122.1</version>
 
   <documentation>The SAPUI5 Core Runtime.
 

package/src/sap/ui/core/BusyIndicator.js

@@ -42,7 +42,7 @@ sap.ui.define([
 	 * Provides methods to show or hide a waiting animation covering the whole
 	 * page and blocking user interaction.
 	 * @namespace
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @alias sap.ui.core.BusyIndicator
 	 */

package/src/sap/ui/core/Component.js

@@ -20,6 +20,7 @@ sap.ui.define([
 	'sap/ui/core/ResizeHandler',
 	'sap/ui/thirdparty/URI',
 	'sap/ui/performance/trace/Interaction',
+	'sap/ui/util/_enforceNoReturnValue',
 	'sap/base/assert',
 	'sap/base/Log',
 	'sap/base/util/Deferred',
@@ -47,6 +48,7 @@ sap.ui.define([
 	ResizeHandler,
 	URI,
 	Interaction,
+	_enforceNoReturnValue,
 	assert,
 	Log,
 	Deferred,
@@ -236,7 +238,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.Component
 	 * @since 1.9.2
 	 */
@@ -1325,7 +1327,7 @@ sap.ui.define([
 	 * @param {string} [vUsage.id] ID of the nested component that is prefixed with <code>autoPrefixId</code>
 	 * @param {boolean} [vUsage.async=true] Indicates whether the component creation is done asynchronously (You should use synchronous creation only if really necessary, because this has a negative impact on performance.)
 	 * @param {object} [vUsage.settings] Settings for the nested component like for {#link sap.ui.component} or the component constructor
-	 * @param {object} [vUsage.componentData] Initial data of the component (@see sap.ui.core.Component#getComponentData)
+	 * @param {object} [vUsage.componentData] Initial data of the component, see {@link sap.ui.core.Component#getComponentData}
 	 * @return {sap.ui.core.Component|Promise<sap.ui.core.Component>} Component instance or Promise which will be resolved with the component instance (defaults to Promise / asynchronous behavior)
 	 * @public
 	 * @since 1.47.0
@@ -1412,6 +1414,13 @@ sap.ui.define([
 	 *
 	 * @function
 	 * @name sap.ui.core.Component.prototype.init
+	 * @returns {void|undefined} This hook method must not have a return value. Return value <code>void</code> is deprecated since 1.120, as it does not force functions to <b>not</b> return something.
+	 * 	This implies that, for instance, no async function returning a Promise should be used.
+	 *
+	 * 	<b>Note:</b> While the return type is currently <code>void|undefined</code>, any
+	 *	implementation of this hook must not return anything but undefined. Any other
+	 * 	return value will cause an error log in this version of UI5 and will fail in future
+	 * 	major versions of UI5.
 	 * @protected
 	 */
 	//Component.prototype.init = function() {};
@@ -1427,6 +1436,13 @@ sap.ui.define([
 	 *
 	 * @function
 	 * @name sap.ui.core.Component.prototype.exit
+	 * @returns {void|undefined} This hook method must not have a return value. Return value <code>void</code> is deprecated since 1.120, as it does not force functions to <b>not</b> return something.
+	 * 	This implies that, for instance, no async function returning a Promise should be used.
+	 *
+	 * 	<b>Note:</b> While the return type is currently <code>void|undefined</code>, any
+	 *	implementation of this hook must not return anything but undefined. Any other
+	 * 	return value will cause an error log in this version of UI5 and will fail in future
+	 * 	major versions of UI5.
 	 * @protected
 	 */
 	//Component.prototype.exit = function() {};
@@ -2509,7 +2525,7 @@ sap.ui.define([
 	 *              <code>vConfig.manifest</code> is set to a non-empty string), then the name specified in that
 	 *              manifest will be ignored and this name will be used instead to determine the module to be loaded.
 	 * @param {string} [vConfig.url] Alternative location from where to load the Component. If a <code>manifestUrl</code> is given, this URL specifies the location of the final component defined via that manifest, otherwise it specifies the location of the component defined via its name <code>vConfig.name</code>.
-	 * @param {object} [vConfig.componentData] Initial data of the Component (@see sap.ui.core.Component#getComponentData)
+	 * @param {object} [vConfig.componentData] Initial data of the Component, see {@link sap.ui.core.Component#getComponentData}
 	 * @param {string} [vConfig.id] sId of the new Component
 	 * @param {object} [vConfig.settings] Settings of the new Component
 	 * @param {string[]} [vConfig.activeTerminologies] List of active terminologies.
@@ -3943,7 +3959,7 @@ sap.ui.define([
 
 		// call lifecyclehook 'onDeactivate'
 		if (typeof this.onDeactivate === "function") {
-			this.onDeactivate();
+			_enforceNoReturnValue(this.onDeactivate(), /*mLogInfo=*/{name: "onDeactivate", component: this.getId()});
 		}
 	};
 
@@ -4006,7 +4022,7 @@ sap.ui.define([
 
 		// call lifecyclehook 'onActivate'
 		if (typeof this.onActivate === "function") {
-			this.onActivate();
+			_enforceNoReturnValue(this.onActivate(), /*mLogInfo=*/{ name: "onActivate", component: this.getId() });
 		}
 	};
 
@@ -4058,6 +4074,12 @@ sap.ui.define([
 	 * @name sap.ui.core.Component.prototype.onActivate
 	 * @abstract
 	 * @since 1.88
+	 * @returns {void|undefined} This lifecycle hook must not have a return value.
+	 *
+	 * 	<b>Note:</b> While the return type is currently <code>void|undefined</code>, any
+	 *	implementation of this hook must not return anything but undefined. Any other
+	 * 	return value will cause an error log in this version of UI5 and will fail in future
+	 * 	major versions of UI5.
 	 * @protected
 	 */
 
@@ -4068,6 +4090,12 @@ sap.ui.define([
 	 * @name sap.ui.core.Component.prototype.onDeactivate
 	 * @abstract
 	 * @since 1.88
+	 * @returns {void|undefined} This lifecycle hook must not have a return value.
+	 *
+	 * 	<b>Note:</b> While the return type is currently <code>void|undefined</code>, any
+	 *	implementation of this hook must not return anything but undefined. Any other
+	 * 	return value will cause an error log in this version of UI5 and will fail in future
+	 * 	major versions of UI5.
 	 * @protected
 	 */
 

package/src/sap/ui/core/ComponentContainer.js

@@ -58,7 +58,7 @@ sap.ui.define([
 	 * See also {@link module:sap/ui/core/ComponentSupport}.
 	 *
 	 * @extends sap.ui.core.Control
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.ComponentContainer

package/src/sap/ui/core/ComponentMetadata.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @public
 	 * @class
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @since 1.9.2
 	 * @alias sap.ui.core.ComponentMetadata
 	 * @extends sap.ui.base.ManagedObjectMetadata

package/src/sap/ui/core/ComponentSupport.js

@@ -111,7 +111,7 @@ sap.ui.define([
 	 * @author SAP SE
 	 * @public
 	 * @since 1.58.0
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @namespace
 	 * @alias module:sap/ui/core/ComponentSupport
 	 */

package/src/sap/ui/core/Configuration.js

@@ -41,7 +41,7 @@ sap.ui.define([
 ) {
 	"use strict";
 
-	var oVersion = new Version("1.121.1");
+	var oVersion = new Version("1.122.1");
 	var oFormatSettings;
 
 	// Lazy dependency to core

package/src/sap/ui/core/Control.js

@@ -84,7 +84,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.Control
 	 */
 	var Control = Element.extend("sap.ui.core.Control", /** @lends sap.ui.core.Control.prototype */ {
@@ -749,11 +749,19 @@ sap.ui.define([
 	 * Subclasses of Control should override this hook to implement any necessary actions before the rendering.
 	 *
 	 * @param {jQuery.Event} oEvent onBeforeRendering event object
+	 * @returns {void|undefined} This hook method must not have a return value. Return value <code>void</code> is deprecated since 1.120, as it does not force functions to <b>not</b> return something.
+	 * 	This implies that, for instance, no async function returning a Promise should be used.
+	 *
+	 * 	<b>Note:</b> While the return type is currently <code>void|undefined</code>, any
+	 *	implementation of this hook must not return anything but undefined. Any other
+	 * 	return value will cause an error log in this version of UI5 and will fail in future
+	 * 	major versions of UI5.
 	 * @protected
 	 */
-	Control.prototype.onBeforeRendering = function(oEvent) {
+	Control.prototype.onBeforeRendering = function() {
 		// Before adding any implementation, please remember that this method was first implemented in release 1.54.
 		// Therefore, many subclasses will not call this method at all.
+		return undefined;
 	};
 
 	/**
@@ -764,11 +772,19 @@ sap.ui.define([
 	 * Subclasses of Control should override this hook to implement any necessary actions after the rendering.
 	 *
 	 * @param {jQuery.Event} oEvent onAfterRendering event object
+	 * @returns {void|undefined} This hook method must not have a return value. Return value <code>void</code> is deprecated since 1.120, as it does not force functions to <b>not</b> return something.
+	 * 	This implies that, for instance, no async function returning a Promise should be used.
+	 *
+	 * 	<b>Note:</b> While the return type is currently <code>void|undefined</code>, any
+	 *	implementation of this hook must not return anything but undefined. Any other
+	 * 	return value will cause an error log in this version of UI5 and will fail in future
+	 * 	major versions of UI5.
 	 * @protected
 	 */
-	Control.prototype.onAfterRendering = function(oEvent) {
+	Control.prototype.onAfterRendering = function() {
 		// Before adding any implementation, please remember that this method was first implemented in release 1.54.
 		// Therefore, many subclasses will not call this method at all.
+		return undefined;
 	};
 
 	/**

package/src/sap/ui/core/Core.js

@@ -380,7 +380,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 * @final
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.Core
 	 * @public
 	 * @hideconstructor

package/src/sap/ui/core/CustomData.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * in the documentation.
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.CustomData

package/src/sap/ui/core/DeclarativeSupport.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @class Static class for enabling declarative UI support.
 	 *
 	 * @author Peter Muessig, Tino Butz
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @since 1.7.0
 	 * @public
 	 * @alias sap.ui.core.DeclarativeSupport