@openui5/sap.ui.core 1.121.1 → 1.122.1

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

@@ -16,6 +16,7 @@ sap.ui.define([
 	"sap/base/assert",
 	"sap/ui/thirdparty/jquery",
 	"sap/ui/events/F6Navigation",
+	"sap/ui/util/_enforceNoReturnValue",
 	"./RenderManager",
 	"./EnabledPropagator",
 	"./ElementRegistry",
@@ -33,6 +34,7 @@ sap.ui.define([
 		assert,
 		jQuery,
 		F6Navigation,
+		_enforceNoReturnValue,
 		RenderManager,
 		EnabledPropagator,
 		ElementRegistry,
@@ -132,7 +134,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @alias sap.ui.core.Element
 	 */
@@ -336,14 +338,20 @@ sap.ui.define([
 		}
 
 		each(this.aBeforeDelegates);
+
 		if ( oEvent.isImmediateHandlerPropagationStopped() ) {
 			return;
 		}
 		if ( this[sHandlerName] ) {
-			this[sHandlerName](oEvent);
+			if (oEvent._bNoReturnValue) {
+				// fatal throw if listener isn't allowed to have a return value
+				_enforceNoReturnValue(this[sHandlerName](oEvent), /*mLogInfo=*/{ name: sHandlerName, component: this.getId() });
+			} else {
+				this[sHandlerName](oEvent);
+			}
 		}
-		each(this.aDelegates);
 
+		each(this.aDelegates);
 	};
 
 
@@ -355,11 +363,19 @@ sap.ui.define([
 	 *
 	 * Subclasses of Element should override this hook to implement any necessary initialization.
 	 *
+	 * @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
 	 */
 	Element.prototype.init = 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;
 	};
 
 	/**
@@ -384,11 +400,19 @@ sap.ui.define([
 	 * For a more detailed description how to to use the exit hook, see Section
 	 * {@link topic:d4ac0edbc467483585d0c53a282505a5 exit() Method} in the documentation.
 	 *
+	 * @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
 	 */
 	Element.prototype.exit = 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;
 	};
 
 	/**
@@ -1958,6 +1982,7 @@ sap.ui.define([
 		var oJQueryEvent = jQuery.Event("ThemeChanged");
 		oJQueryEvent.theme = oEvent.theme;
 		ElementRegistry.forEach(function(oElement) {
+			oJQueryEvent._bNoReturnValue = true; // themeChanged handler aren't allowed to have any retun value. Mark for future fatal throw.
 			oElement._handleEvent(oJQueryEvent);
 		});
 	});

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

@@ -36,7 +36,7 @@ sap.ui.define([
 	 *
 	 * @class
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @since 0.8.6
 	 * @alias sap.ui.core.ElementMetadata
 	 * @extends sap.ui.base.ManagedObjectMetadata

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

@@ -43,7 +43,7 @@ sap.ui.define([
 	 *
 	 * @param {boolean} [bDefault=true] Value that should be used as default value for the enhancement of the control.
 	 * @param {boolean} [bLegacy=false] Whether the introduced property should use the old name <code>Enabled</code>.
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @class
 	 * @alias sap.ui.core.EnabledPropagator

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

@@ -31,7 +31,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @since 1.8.0
 	 * @alias sap.ui.core.EventBus

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

@@ -99,7 +99,7 @@ function(
 	 * @class
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @alias sap.ui.core.Fragment
 	 */

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

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.HTML

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

@@ -22,7 +22,7 @@ sap.ui.define(['sap/ui/base/Object', "sap/ui/util/Storage"],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.History
 	 * @protected
 	 */

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

@@ -75,7 +75,7 @@ sap.ui.define([
 	 * @implements sap.ui.core.IFormContent
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @since 1.11.1

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

@@ -16,7 +16,7 @@ sap.ui.define(['./library', 'sap/ui/core/Lib'],
 		 * Helper functionality for indication color support.
 		 *
 		 * @author SAP SE
-		 * @version 1.121.1
+		 * @version 1.122.1
 		 * @public
 		 * @namespace sap.ui.core.IndicationColorSupport
 		 * @since 1.66

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

@@ -23,7 +23,7 @@ sap.ui.define(['../base/Object', './EventBus', "sap/base/assert"],
 		 *
 		 * @extends sap.ui.base.Object
 		 * @author SAP SE
-		 * @version 1.121.1
+		 * @version 1.122.1
 		 * @public
 		 * @since 1.11.0
 		 * @alias sap.ui.core.IntervalTrigger

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

@@ -35,7 +35,7 @@ sap.ui.define(["./library", "./Core", "sap/ui/base/ManagedObject", "sap/base/Log
 		 * @extends sap.ui.base.ManagedObject
 		 *
 		 * @author SAP SE
-		 * @version 1.121.1
+		 * @version 1.122.1
 		 * @hideconstructor
 		 * @public
 		 * @since 1.78

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

@@ -12,7 +12,7 @@ sap.ui.define([], function() {
 	 * Provides the default renderer for the controls that have set their <code>visible</code> property to <code>false</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias module:sap/ui/core/InvisibleRenderer
 	 * @since 1.66.0
 	 * @protected

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

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @since 1.27.0

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

@@ -24,7 +24,7 @@ sap.ui.define(['./Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.Item

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

@@ -144,7 +144,7 @@ sap.ui.define(['../base/ManagedObject', "sap/base/assert"],
 	 * @see sap.ui.core.LabelEnablement#enrich
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @protected
 	 * @alias sap.ui.core.LabelEnablement
 	 * @namespace

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

@@ -23,7 +23,7 @@ sap.ui.define(['./Element', "sap/ui/thirdparty/jquery", './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.LayoutData

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

@@ -23,7 +23,7 @@ sap.ui.define(['./Item', './library'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.ListItem

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

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @since 1.11.0

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

@@ -20,7 +20,7 @@ sap.ui.define(['sap/base/assert', 'sap/ui/base/Object', "sap/base/i18n/Localizat
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @alias sap.ui.core.Locale
 	 */

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

@@ -23,11 +23,19 @@ sap.ui.define([
 
 	var rCIgnoreCase = /c/i,
 		rEIgnoreCase = /e/i,
-		/*
-		* With the upgrade of the CLDR to version 41 some unit keys have changed.
-		* For compatibility reasons this map is used for formatting units.
-		* It maps a legacy unit key to its renamed key.
-		*/
+		/**
+		 * With the upgrade of the CLDR to version 41 some unit keys have changed.
+		 * For compatibility reasons this map is used for formatting units.
+		 * It maps a legacy unit key to its renamed key.
+		 *
+		 * @deprecated As of version 1.122.0, this map is no longer maintained and stays for compatibility reasons
+		 *   only. Reason for the depreciation: The assumption of homogeneous unit keys in the CLDR data has been proven
+		 *   wrong. Additionally, it is unclear if, those CLDR unit keys are actually used. Implementing a complex logic
+		 *   to maintain potentially unused entries did not seem reasonable. Therefore, it was decided to deprecate this
+		 *   feature.
+		 *   This map was last updated with CLDR V43, in 1.119.0.
+		 * @private
+		 */
 		mLegacyUnit2CurrentUnit = {
 			"acceleration-meter-per-second-squared": "acceleration-meter-per-square-second",
 			"concentr-milligram-per-deciliter": "concentr-milligram-ofglucose-per-deciliter",
@@ -53,7 +61,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 * @alias sap.ui.core.LocaleData
 	 */

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

@@ -148,7 +148,7 @@ sap.ui.define([
 	 * @class The Manifest class.
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.Manifest
 	 * @since 1.33.0
 	 */

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

@@ -26,7 +26,7 @@ sap.ui.define(['./Element', './library', "./Theming", "sap/base/Log"],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.Message

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

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

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

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @classdesc Base Class for a Renderer.
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @namespace
 	 * @public
 	 * @alias sap.ui.core.Renderer

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

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @alias sap.ui.core.ResizeHandler
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @public
 	 */
 

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

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * The ScrollBar control can be used for virtual scrolling of a certain area.
 	 * This means: to simulate a very large scrollable area when technically the area is small and the control takes care of displaying the respective part only. E.g. a Table control can take care of only rendering the currently visible rows and use this ScrollBar control to make the user think he actually scrolls through a long list.
 	 * @extends sap.ui.core.Control
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @deprecated as of version 1.56

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

@@ -23,7 +23,7 @@ sap.ui.define(['./Item', './library'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.SeparatorItem

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

@@ -25,7 +25,7 @@ sap.ui.define(['./Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @since 1.16.0

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

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @class
 	 * Abstract class that can be extended in order to implement any extended tooltip. For example, RichTooltip Control is based on it. It provides the opening/closing behavior and the main "text" property.
 	 * @extends sap.ui.core.Control
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.TooltipBase

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

@@ -170,7 +170,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @param {object} [oRootNode] reference to the DOM element that should be 'hosting' the UI Area.
 	 * @public
 	 * @alias sap.ui.core.UIArea

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

@@ -57,7 +57,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Component
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @alias sap.ui.core.UIComponent
 	 * @since 1.9.2
 	 */

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

@@ -18,7 +18,7 @@ sap.ui.define(['./ComponentMetadata', 'sap/ui/core/mvc/ViewType'],
 	 * @experimental Since 1.15.1. The Component concept is still under construction, so some implementation details can be changed in future.
 	 * @class
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @since 1.15.1
 	 * @alias sap.ui.core.UIComponentMetadata
 	 * @extends sap.ui.core.ComponentMetadata

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

@@ -16,7 +16,7 @@ sap.ui.define(['./Element', './library', './Lib', "sap/base/assert"],
 		 * Helper functionality for value state support.
 		 *
 		 * @author SAP SE
-		 * @version 1.121.1
+		 * @version 1.122.1
 		 * @public
 		 * @namespace sap.ui.core.ValueStateSupport
 		 */

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

@@ -20,7 +20,7 @@ sap.ui.define(['./LayoutData', './library'],
 	 * @class
 	 * Allows to add multiple LayoutData to one control in case that an easy switch of layouts (e.g. in a Form) is needed.
 	 * @extends sap.ui.core.LayoutData
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 *
 	 * @public
 	 * @since 1.9.2

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

@@ -148,7 +148,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.121.1
+		 * @version 1.122.1
 		 * @since 1.56.0
 		 * @alias sap.ui.core.XMLComposite
 		 * @see {@link topic:b83a4dcb7d0e46969027345b8d32fd44 XML Composite Controls}

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

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @param {object} oClassInfo static info to construct the metadata from
 	 *
 	 * @author SAP SE
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 * @since 1.50.0
 	 * @alias sap.ui.core.XMLCompositeMetadata
 	 * @extends sap.ui.core.ElementMetadata

package/src/sap/ui/core/date/UI5Date.js

@@ -66,7 +66,7 @@ sap.ui.define([
 	 * @hideconstructor
 	 * @public
 	 * @since 1.111.0
-	 * @version 1.121.1
+	 * @version 1.122.1
 	 */
 	function UI5Date(vDateParts, sTimezoneID) {
 		var oDateInstance = UI5Date._createDateInstance(vDateParts);