@openui5/sap.ui.core 1.120.1 → 1.120.3

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -26,10 +26,11 @@ sap.ui.define(['./Element', './library', "./Theming", "sap/base/Log"],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.120.1
+	 * @version 1.120.3
 	 *
 	 * @public
 	 * @alias sap.ui.core.Message
+	 * @deprecated As of version 1.120. Please use {@link sap.ui.core.message.Message} instead.
 	 */
 	var Message = Element.extend("sap.ui.core.Message", /** @lends sap.ui.core.Message.prototype */ { metadata : {
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -166,7 +166,7 @@ sap.ui.define([
 		 */
 		registerObject: function(oObject, bHandleValidation) {
 			if (!(oObject && oObject.isA && (oObject.isA(["sap.ui.base.ManagedObject", "sap.ui.core.Core"])))) {
-				Log.error("Messaging: " + oObject.toString() + " is not an instance of sap.ui.base.ManagedObject");
+				Log.error("[FUTURE FATAL] Messaging: " + oObject.toString() + " is not an instance of sap.ui.base.ManagedObject");
 			} else {
 				oObject.attachValidationSuccess(bHandleValidation, _handleSuccess);
 				oObject.attachValidationError(bHandleValidation, _handleError);
@@ -183,7 +183,7 @@ sap.ui.define([
 		 */
 		unregisterObject: function(oObject) {
 			if (!(oObject && oObject.isA && oObject.isA("sap.ui.base.ManagedObject"))) {
-				Log.error("Messaging: " + oObject.toString() + " is not an instance of sap.ui.base.ManagedObject");
+				Log.error("[FUTURE FATAL] Messaging: " + oObject.toString() + " is not an instance of sap.ui.base.ManagedObject");
 			} else {
 				oObject.detachValidationSuccess(_handleSuccess);
 				oObject.detachValidationError(_handleError);

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -236,7 +236,7 @@ sap.ui.define([
 	 *
 	 * @extends Object
 	 * @author SAP SE
-	 * @version 1.120.1
+	 * @version 1.120.3
 	 * @alias sap.ui.core.RenderManager
 	 * @hideconstructor
 	 * @public

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @classdesc Base Class for a Renderer.
 	 *
 	 * @author SAP SE
-	 * @version 1.120.1
+	 * @version 1.120.3
 	 * @namespace
 	 * @public
 	 * @alias sap.ui.core.Renderer

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @alias sap.ui.core.ResizeHandler
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.120.1
+	 * @version 1.120.3
 	 * @public
 	 */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -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.120.1
+	 * @version 1.120.3
 	 *
 	 * @public
 	 * @deprecated as of version 1.56

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -23,7 +23,7 @@ sap.ui.define(['./Item', './library'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.120.1
+	 * @version 1.120.3
 	 *
 	 * @public
 	 * @alias sap.ui.core.SeparatorItem

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -110,18 +110,24 @@ sap.ui.define([
 				// add span to static-ui-area
 				oStaticAreaDomRef.appendChild(oSpan);
 
-				// set focus on span to enforce blur - e.g. data of input field needs to get peristed
-				oSpan.focus();
-				// setting back the focus async ensures that also a fieldGroupChange happens
+				// switch the focus after the current call stack because some input device (e.g. Barcode scanner) fires
+				// the "keyup" event in a 0 timeout after the 'keydown' event. We need to make sure that the element can
+				// receive both of the events before we switch the focus to the "span"
 				setTimeout(function() {
-					// restore old focus
-					oFocusedElement.focus();
+					// set focus on span to enforce blur - e.g. data of input field needs to get persisted
+					oSpan.focus();
 
-					// cleanup DOM
-					oStaticAreaDomRef.removeChild(oSpan);
+					// setting back the focus async ensures that also a fieldGroupChange happens
+					setTimeout(function() {
+						// restore old focus
+						oFocusedElement.focus();
 
-					// trigger callback
-					fnCallback.apply(null, args);
+						// cleanup DOM
+						oStaticAreaDomRef.removeChild(oSpan);
+
+						// trigger callback
+						fnCallback.apply(null, args);
+					});
 				});
 			}
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,15 +1,17 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
 	"sap/base/i18n/Localization",
 	"./UIArea",
+	"./UIAreaRegistry",
 	"sap/ui/dom/_ready"
 ], (
 	Localization,
 	UIArea,
+	UIAreaRegistry,
 	_ready
 ) => {
 	"use strict";
@@ -58,7 +60,7 @@ sap.ui.define([
 		 */
 		getUIArea: () => {
 			if (!oStaticArea) {
-				oStaticArea = UIArea.registry.get(StaticArea.STATIC_UIAREA_ID) || UIArea.create(_createStaticAreaRef());
+				oStaticArea = UIAreaRegistry.get(StaticArea.STATIC_UIAREA_ID) || UIArea.create(_createStaticAreaRef());
 				oStaticArea.bInitial = false;
 			}
 			return oStaticArea;
@@ -120,6 +122,7 @@ sap.ui.define([
 
 			oFirstFocusElement.setAttribute("id", StaticArea.STATIC_UIAREA_ID + "-firstfe");
 			oFirstFocusElement.setAttribute("tabindex", -1);
+			oFirstFocusElement.setAttribute("aria-hidden", true);
 			oFirstFocusElement.style.fontSize = 0;
 
 			oStaticArea.appendChild(oFirstFocusElement);

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([

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

@@ -130,7 +130,7 @@ sap.ui.define([
 		getThemeRoot: (sTheme, sLib) => {
 			const oThemeRoots = oWritableConfig.get({
 				name: "sapUiThemeRoots",
-				type: oWritableConfig.Type.Object
+				type: oWritableConfig.Type.MergedObject
 			});
 			let sThemeRoot;
 
@@ -202,7 +202,7 @@ sap.ui.define([
 
 			const oThemeRootConfigParam = {
 				name: "sapUiThemeRoots",
-				type: oWritableConfig.Type.Object
+				type: oWritableConfig.Type.MergedObject
 			};
 
 			// Use get twice, for a deep copy of themeRoots object
@@ -519,7 +519,7 @@ sap.ui.define([
 				sAllowedOrigin = bNoProtocol && !sAllowedOrigin.startsWith("//") ? "//" + sAllowedOrigin : sAllowedOrigin;
 				return sAllowedOrigin === "*" || sOrigin === new URL(sAllowedOrigin.trim(), globalThis.location.href).origin;
 			} catch (error) {
-				Log.error("sapAllowedThemeOrigin provides invalid theme origin: " + sAllowedOrigin);
+				Log.error("[FUTURE FATAL] sapAllowedThemeOrigin provides invalid theme origin: " + sAllowedOrigin);
 				return false;
 			}
 		});

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -25,7 +25,7 @@ sap.ui.define(['./Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.120.1
+	 * @version 1.120.3
 	 *
 	 * @public
 	 * @since 1.16.0

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -31,7 +31,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.120.1
+	 * @version 1.120.3
 	 *
 	 * @public
 	 * @alias sap.ui.core.TooltipBase

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

@@ -1,15 +1,15 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
 // Provides class sap.ui.core.UIArea
 sap.ui.define([
 	'sap/ui/base/ManagedObject',
-	'sap/ui/base/ManagedObjectRegistry',
 	'./Element',
 	'./RenderManager',
+	'./UIAreaRegistry',
 	'./FocusHandler',
 	'sap/ui/performance/trace/Interaction',
 	"sap/ui/util/ActivityDetection",
@@ -29,9 +29,9 @@ sap.ui.define([
 ],
 	function(
 		ManagedObject,
-		ManagedObjectRegistry,
 		Element,
 		RenderManager,
+		UIAreaRegistry,
 		FocusHandler,
 		Interaction,
 		ActivityDetection,
@@ -170,7 +170,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.120.1
+	 * @version 1.120.3
 	 * @param {object} [oRootNode] reference to the DOM element that should be 'hosting' the UI Area.
 	 * @public
 	 * @alias sap.ui.core.UIArea
@@ -1317,14 +1317,7 @@ sap.ui.define([
 		return null;
 	};
 
-	// apply the registry mixin
-	ManagedObjectRegistry.apply(UIArea, {
-		onDuplicate: function(sId, oldUIArea, newUIArea) {
-			var sMsg = "adding UIArea with duplicate id '" + sId + "'";
-			Log.error(sMsg);
-			throw new Error("Error: " + sMsg);
-		}
-	});
+	UIAreaRegistry.init(UIArea);
 
 	// field group static members
 
@@ -1390,7 +1383,7 @@ sap.ui.define([
 
 		// create a new or fetch an existing UIArea
 		var sId = oDomRef.id;
-		var oUIArea = UIArea.registry.get(sId);
+		var oUIArea = UIAreaRegistry.get(sId);
 		if (!oUIArea) {
 			oUIArea = new UIArea(oDomRef);
 			if (oCore && !isEmptyObject(oCore.oModels)) {
@@ -1437,7 +1430,9 @@ sap.ui.define([
 	 * @namespace sap.ui.core.UIArea.registry
 	 * @public
 	 * @since 1.107
+	 * @deprecated As of version 1.120
 	 */
+	UIArea.registry = UIAreaRegistry;
 
 	/**
 	 * Number of existing UIAreas.
@@ -1446,6 +1441,45 @@ sap.ui.define([
 	 * @readonly
 	 * @name sap.ui.core.UIArea.registry.size
 	 * @public
+	 * @deprecated As of version 1.120
+	 */
+
+	/**
+	 * Return an object with all instances of <code>sap.ui.core.UIArea</code>,
+	 * keyed by their ID.
+	 *
+	 * Each call creates a new snapshot object. Depending on the size of the UI,
+	 * this operation therefore might be expensive. Consider to use the <code>forEach</code>
+	 * or <code>filter</code> method instead of executing similar operations on the returned
+	 * object.
+	 *
+	 * <b>Note</b>: The returned object is created by a call to <code>Object.create(null)</code>,
+	 * and therefore lacks all methods of <code>Object.prototype</code>, e.g. <code>toString</code> etc.
+	 *
+	 * @returns {Object<sap.ui.core.ID,sap.ui.core.UIArea>} Object with all UIAreas, keyed by their ID
+	 * @name sap.ui.core.UIArea.registry.all
+	 * @function
+	 * @public
+	 * @deprecated As of version 1.120
+	 */
+
+	/**
+	 * Return an object with all instances of <code>sap.ui.core.UIArea</code>,
+	 * keyed by their ID.
+	 *
+	 * Each call creates a new snapshot object. Depending on the size of the UI,
+	 * this operation therefore might be expensive. Consider to use the <code>forEach</code>
+	 * or <code>filter</code> method instead of executing similar operations on the returned
+	 * object.
+	 *
+	 * <b>Note</b>: The returned object is created by a call to <code>Object.create(null)</code>,
+	 * and therefore lacks all methods of <code>Object.prototype</code>, e.g. <code>toString</code> etc.
+	 *
+	 * @returns {Object<sap.ui.core.ID,sap.ui.core.UIArea>} Object with all UIAreas, keyed by their ID
+	 * @name sap.ui.core.UIArea.registry.all
+	 * @function
+	 * @public
+	 * @deprecated As of version 1.120
 	 */
 
 	/**
@@ -1464,6 +1498,7 @@ sap.ui.define([
 	 * @name sap.ui.core.UIArea.registry.all
 	 * @function
 	 * @public
+	 * @deprecated As of version 1.120
 	 */
 
 	/**
@@ -1477,6 +1512,7 @@ sap.ui.define([
 	 * @name sap.ui.core.UIArea.registry.get
 	 * @function
 	 * @public
+	 * @deprecated As of version 1.120
 	 */
 
 	/**
@@ -1511,6 +1547,7 @@ sap.ui.define([
 	 * @name sap.ui.core.UIArea.registry.forEach
 	 * @function
 	 * @public
+	 * @deprecated As of version 1.120
 	 */
 
 	/**
@@ -1549,9 +1586,10 @@ sap.ui.define([
 	 * @name sap.ui.core.UIArea.registry.filter
 	 * @function
 	 * @public
+	 * @deprecated As of version 1.120
 	 */
 
-	_LocalizationHelper.registerForUpdate("UIAreas", UIArea.registry.all);
+	_LocalizationHelper.registerForUpdate("UIAreas", UIAreaRegistry.all);
 
 	return UIArea;
 });

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

@@ -0,0 +1,150 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+	"sap/base/Log",
+	"sap/ui/base/ManagedObjectRegistry"
+], (
+	Log,
+	ManagedObjectRegistry
+) => {
+	"use strict";
+
+	const fnOnDuplicate = function(sId, oldUIArea, newUIArea) {
+        var sMsg = "adding UIArea with duplicate id '" + sId + "'";
+        Log.error(sMsg);
+        throw new Error("Error: " + sMsg);
+    };
+
+	/**
+	 * Registry of all <code>sap.ui.core.UIArea</code>s that currently exist.
+	 *
+	 * @namespace sap.ui.core.UIAreaRegistry
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+	const UIAreaRegistry = ManagedObjectRegistry.create({
+		"onDuplicate": fnOnDuplicate
+	});
+
+	/**
+	 * Number of existing UIAreas.
+	 *
+	 * @type {int}
+	 * @readonly
+	 * @name module:sap/ui/core/UIAreaRegistry.size
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+
+	/**
+	 * Return an object with all instances of <code>sap.ui.core.UIArea</code>,
+	 * keyed by their ID.
+	 *
+	 * Each call creates a new snapshot object. Depending on the size of the UI,
+	 * this operation therefore might be expensive. Consider to use the <code>forEach</code>
+	 * or <code>filter</code> method instead of executinTg similar operations on the returned
+	 * object.
+	 *
+	 * <b>Note</b>: The returned object is created by a call to <code>Object.create(null)</code>,
+	 * and therefore lacks all methods of <code>Object.prototype</code>, e.g. <code>toString</code> etc.
+	 *
+	 * @returns {Object<sap.ui.core.ID,sap.ui.core.UIArea>} Object with all UIAreas, keyed by their ID
+	 * @name module:sap/ui/core/UIAreaRegistry.all
+	 * @function
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+
+	/**
+	 * Retrieves an UIArea by its ID.
+	 *
+	 * When the ID is <code>null</code> or <code>undefined</code> or when there's no UIArea with
+	 * the given ID, then <code>undefined</code> is returned.
+	 *
+	 * @param {sap.ui.core.ID} id ID of the UIArea to retrieve
+	 * @returns {sap.ui.core.UIArea|undefined} UIArea with the given ID or <code>undefined</code>
+	 * @name module:sap/ui/core/UIAreaRegistry.get
+	 * @function
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+
+	/**
+	 * Calls the given <code>callback</code> for each UIArea.
+	 *
+	 * The expected signature of the callback is
+	 * <pre>
+	 *    function callback(oUIArea, sID)
+	 * </pre>
+	 * where <code>oUIArea</code> is the currently visited UIArea instance and <code>sID</code>
+	 * is the ID of that instance.
+	 *
+	 * The order in which the callback is called for UIAreas is not specified and might change between
+	 * calls (over time and across different versions of UI5).
+	 *
+	 * If UIAreas are created or destroyed within the <code>callback</code>, then the behavior is
+	 * not specified. Newly added objects might or might not be visited. When an UIArea is destroyed or
+	 * the root node is changed during the filtering and was not visited yet, it might or might not be
+	 * visited. As the behavior for such concurrent modifications is not specified, it may change in
+	 * newer releases.
+	 *
+	 * If a <code>thisArg</code> is given, it will be provided as <code>this</code> context when calling
+	 * <code>callback</code>. The <code>this</code> value that the implementation of <code>callback</code>
+	 * sees, depends on the usual resolution mechanism. E.g. when <code>callback</code> was bound to some
+	 * context object, that object wins over the given <code>thisArg</code>.
+	 *
+	 * @param {function(sap.ui.core.UIArea,sap.ui.core.ID)} callback
+	 *        Function to call for each UIArea
+	 * @param {Object} [thisArg=undefined]
+	 *        Context object to provide as <code>this</code> in each call of <code>callback</code>
+	 * @throws {TypeError} If <code>callback</code> is not a function
+	 * @name module:sap/ui/core/UIAreaRegistry.forEach
+	 * @function
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+
+	/**
+	 * Returns an array with UIAreas for which the given <code>callback</code> returns a value that coerces
+	 * to <code>true</code>.
+	 *
+	 * The expected signature of the callback is
+	 * <pre>
+	 *    function callback(oUIArea, sID)
+	 * </pre>
+	 * where <code>oUIArea</code> is the currently visited UIArea instance and <code>sID</code>
+	 * is the ID of that instance.
+	 *
+	 * If UIAreas are created or destroyed within the <code>callback</code>, then the behavior is
+	 * not specified. Newly added objects might or might not be visited. When an UIArea is destroyed or
+	 * the root node is changed during the filtering and was not visited yet, it might or might not be
+	 * visited. As the behavior for such concurrent modifications is not specified, it may change in
+	 * newer releases.
+	 *
+	 * If a <code>thisArg</code> is given, it will be provided as <code>this</code> context when calling
+	 * <code>callback</code>. The <code>this</code> value that the implementation of <code>callback</code>
+	 * sees, depends on the usual resolution mechanism. E.g. when <code>callback</code> was bound to some
+	 * context object, that object wins over the given <code>thisArg</code>.
+	 *
+	 * This function returns an array with all UIAreas matching the given predicate. The order of the
+	 * UIAreas in the array is not specified and might change between calls (over time and across different
+	 * versions of UI5).
+	 *
+	 * @param {function(sap.ui.core.UIArea,sap.ui.core.ID):boolean} callback
+	 *        predicate against which each UIArea is tested
+	 * @param {Object} [thisArg=undefined]
+	 *        context object to provide as <code>this</code> in each call of <code>callback</code>
+	 * @returns {sap.ui.core.UIArea[]}
+	 *        Array of UIAreas matching the predicate; order is undefined and might change in newer versions of UI5
+	 * @throws {TypeError} If <code>callback</code> is not a function
+	 * @name module:sap/ui/core/UIAreaRegistry.filter
+	 * @function
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+
+	return UIAreaRegistry;
+});