@openui5/sap.ui.core 1.113.0 → 1.114.1

package/src/sap/ui/model/odata/v4/ODataModel.js

@@ -227,7 +227,7 @@ sap.ui.define([
 		 * @extends sap.ui.model.Model
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.113.0
+		 * @version 1.114.1
 		 */
 		ODataModel = Model.extend("sap.ui.model.odata.v4.ODataModel",
 			/** @lends sap.ui.model.odata.v4.ODataModel.prototype */{

package/src/sap/ui/model/odata/v4/ODataParentBinding.js

@@ -428,11 +428,15 @@ sap.ui.define([
 	};
 
 	/**
-	 * Checks whether the given context may be kept alive.
+	 * Checks whether the given context (or any context of this binding) may be kept alive.
 	 *
-	 * @param {sap.ui.model.odata.v4.Context} oContext
+	 * @param {sap.ui.model.odata.v4.Context} [oContext]
 	 *   A context of this binding
-	 * @throws {Error} If <code>oContext.setKeepAlive()</code> is not allowed
+	 * @param {boolean} [bKeepAlive]
+	 *   Whether to keep the given context alive
+	 * @throws {Error}
+	 *   If <code>oContext.setKeepAlive(bKeepAlive)</code> is not allowed for the given (or any)
+	 *   context
 	 *
 	 * @abstract
 	 * @function

package/src/sap/ui/model/odata/v4/ODataPropertyBinding.js

@@ -42,7 +42,7 @@ sap.ui.define([
 		 * @mixes sap.ui.model.odata.v4.ODataBinding
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.113.0
+		 * @version 1.114.1
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getGroupId as #getGroupId
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getRootBinding as #getRootBinding
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getUpdateGroupId as #getUpdateGroupId
@@ -265,12 +265,9 @@ sap.ui.define([
 			that = this;
 
 		this.oCheckUpdateCallToken = oCallToken;
-		if (this.bHasDeclaredType === undefined) {
-			this.bHasDeclaredType = !!vType;
-		}
-		if (sResolvedPath && !this.bHasDeclaredType && this.sInternalType !== "any"
-				&& !bIsMeta) {
-			vType = oMetaModel.fetchUI5Type(sResolvedPath);
+		if (!vType && sResolvedPath && this.sInternalType !== "any" && !bIsMeta
+				&& !sResolvedPath.includes(sVirtualPath)) {
+			vType = oMetaModel.fetchUI5Type(this.sReducedPath || sResolvedPath);
 		}
 		if (vValue === undefined) {
 			// if called via #onChange, we need to fetch implicit values
@@ -289,9 +286,7 @@ sap.ui.define([
 							return vResult;
 						});
 				}
-				if (!that.sReducedPath || !that.isResolved()) {
-					// binding is unresolved or context was reset by another call to
-					// checkUpdateInternal
+				if (!that.isResolved()) {
 					return undefined;
 				}
 				if (sResolvedPath.includes(sVirtualPath)) {
@@ -332,7 +327,7 @@ sap.ui.define([
 			});
 			if (bForceUpdate && vValue.isFulfilled()) {
 				if (vType && vType.isFulfilled && vType.isFulfilled()) {
-					this.setType(vType.getResult(), this.sInternalType);
+					this.oType = vType.getResult();
 				}
 				this.vValue = vValue.getResult();
 			}
@@ -346,7 +341,7 @@ sap.ui.define([
 
 			if (oCallToken === that.oCheckUpdateCallToken) { // latest call to checkUpdateInternal
 				that.oCheckUpdateCallToken = undefined;
-				that.setType(oType, that.sInternalType);
+				that.oType = oType;
 				if (oCallToken.forceUpdate || that.vValue !== vValue) {
 					that.bInitial = false;
 					that.vValue = vValue;
@@ -679,6 +674,15 @@ sap.ui.define([
 			if (this.bRelative) {
 				this.checkSuspended(true);
 				this.deregisterChangeListener();
+				if (oContext) {
+					if (this.oType && !this.bHasDeclaredType
+						// Note: this.oType => this.sReducedPath
+						&& _Helper.getMetaPath(this.oModel.resolve(this.sPath, oContext))
+							!== _Helper.getMetaPath(this.sReducedPath)) {
+						this.oType = undefined;
+					}
+					this.sReducedPath = undefined;
+				}
 			}
 			this.oContext = oContext;
 			this.sResumeChangeReason = undefined;
@@ -709,6 +713,7 @@ sap.ui.define([
 	ODataPropertyBinding.prototype.setType = function (oType, _sInternalType) {
 		var oOldType = this.oType;
 
+		this.bHasDeclaredType = !!oType;
 		if (oType && oType.getName() === "sap.ui.model.odata.type.DateTimeOffset") {
 			oType.setV4();
 		}

package/src/sap/ui/model/odata/v4/lib/_AggregationCache.js

@@ -42,6 +42,7 @@ sap.ui.define([
 	 *
 	 * @alias sap.ui.model.odata.v4.lib._AggregationCache
 	 * @borrows sap.ui.model.odata.v4.lib._CollectionCache#addKeptElement as #addKeptElement
+	 * @borrows sap.ui.model.odata.v4.lib._CollectionCache#removeKeptElement as #removeKeptElement
 	 * @borrows sap.ui.model.odata.v4.lib._CollectionCache#requestSideEffects as #requestSideEffects
 	 * @constructor
 	 * @extends sap.ui.model.odata.v4.lib._Cache
@@ -82,6 +83,7 @@ sap.ui.define([
 		}
 		this.oFirstLevel = this.createGroupLevelCache(null, bHasGrandTotal || !!fnLeaves);
 		this.addKeptElement = this.oFirstLevel.addKeptElement; // @borrows ...
+		this.removeKeptElement = this.oFirstLevel.removeKeptElement; // @borrows ...
 		this.requestSideEffects = this.oFirstLevel.requestSideEffects; // @borrows ...
 		this.oGrandTotalPromise = undefined;
 		if (bHasGrandTotal) {
@@ -357,13 +359,16 @@ sap.ui.define([
 	 * @param {object|string} vGroupNodeOrPath
 	 *   The group node or its path relative to the cache; a group node instance (instead of a path)
 	 *   MUST only be given in case of "expanding" continued
+	 * @param {function} [fnDataRequested]
+	 *   The function is called just before the back-end request is sent.
+	 *   If no back-end request is needed, the function is not called.
 	 * @returns {sap.ui.base.SyncPromise<number>}
 	 *   A promise that is resolved with the number of nodes at the next level
 	 *
 	 * @public
 	 * @see #collapse
 	 */
-	_AggregationCache.prototype.expand = function (oGroupLock, vGroupNodeOrPath) {
+	_AggregationCache.prototype.expand = function (oGroupLock, vGroupNodeOrPath, fnDataRequested) {
 		var oCache,
 			iCount,
 			aElements = this.aElements,
@@ -417,7 +422,9 @@ sap.ui.define([
 		}
 
 		// prefetch from the group level cache
-		return oCache.read(0, this.iReadLength, 0, oGroupLock).then(function (oResult) {
+		return oCache.read(
+			0, this.iReadLength, 0, oGroupLock, fnDataRequested
+		).then(function (oResult) {
 			var iIndex = that.aElements.indexOf(oGroupNode) + 1,
 				iLevel = oGroupNode["@$ui5.node.level"],
 				oSubtotals = _AggregationHelper.getCollapsedObject(oGroupNode),
@@ -768,7 +775,12 @@ sap.ui.define([
 		}
 
 		return SyncPromise.all(aReadPromises).then(function () {
-			var aElements = that.aElements.slice(iIndex, iIndex + iLength);
+			var aElements = that.aElements.slice(iIndex, iIndex + iLength)
+					.map(function (oElement) {
+						return _Helper.hasPrivateAnnotation(oElement, "placeholder")
+							? undefined
+							: oElement;
+					});
 
 			aElements.$count = that.aElements.$count;
 

package/src/sap/ui/model/odata/v4/lib/_Cache.js

@@ -3366,6 +3366,20 @@ sap.ui.define([
 			});
 	};
 
+	/**
+	 * Removes the element with the given predicate from $byPredicate of the cache's element list.
+	 *
+	 * @param {string} sPredicate - The predicate
+	 * @throws {Error}
+	 *   If the cache is shared
+	 *
+	 * @public
+	 */
+	_CollectionCache.prototype.removeKeptElement = function (sPredicate) {
+		this.checkSharedRequest();
+		delete this.aElements.$byPredicate[sPredicate];
+	};
+
 	/**
 	 * Requests the elements in the given range and places them into the aElements list. Calculates
 	 * the key predicates for all entities in the result before the promise is resolved. While the

package/src/sap/ui/model/odata/v4/lib/_Helper.js

@@ -1553,6 +1553,24 @@ sap.ui.define([
 			return sPath;
 		},
 
+		/**
+		 * Returns the path for the return value context. Supports bound operations on an entity or
+		 * a collection.
+		 *
+		 * @param {string} sPath
+		 *   The bindings's path; either a resolved model path or a resource path; for example:
+		 *   "/Artists(ArtistID='42',IsActiveEntity=true)/special.cases.EditAction(...)" or
+		 *   "/Artists/special.cases.Create(...)", the leading "/" can be omitted.
+		 * @param {string} sResponsePredicate The key predicate of the response entity
+		 * @returns {string} The path for the return value context.
+		 */
+		getReturnValueContextPath : function (sPath, sResponsePredicate) {
+			var sBoundParameterPath = sPath.slice(0, sPath.lastIndexOf("/")),
+				i = sBoundParameterPath.indexOf("(");
+
+			return (i < 0 ? sBoundParameterPath : sPath.slice(0, i)) + sResponsePredicate;
+		},
+
 		/**
 		 * Tells whether <code>sPath</code> has <code>sBasePath</code> as path prefix. It returns
 		 * <code>true</code> iff {@link .getRelativePath} does not return <code>undefined</code>.

package/src/sap/ui/model/odata/v4/lib/_Requestor.js

@@ -429,6 +429,8 @@ sap.ui.define([
 	 * @param {string} [sGroupId]
 	 *   The ID of the group from which the locks shall be canceled; if not given all groups are
 	 *   processed
+	 *
+	 * @private
 	 */
 	_Requestor.prototype.cancelGroupLocks = function (sGroupId) {
 		this.aLockedGroupLocks.forEach(function (oGroupLock) {
@@ -836,6 +838,8 @@ sap.ui.define([
 	 *   complex type)
 	 * @returns {sap.ui.base.SyncPromise<object>}
 	 *   A promise resolving with the type
+	 *
+	 * @public
 	 */
 	 _Requestor.prototype.fetchType = function (mTypeForMetaPath, sMetaPath) {
 		var that = this;
@@ -1901,6 +1905,8 @@ sap.ui.define([
 	/**
 	 * Checks whether a first batch from an earlier app start was recorded and sends it immediately
 	 * out as optimistic batch in order to have its response at the earliest point in time.
+	 *
+	 * @public
 	 */
 	_Requestor.prototype.sendOptimisticBatch = function () {
 		var sKey = window.location.href,

package/src/sap/ui/model/resource/ResourceModel.js

@@ -229,7 +229,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.model.Model
 	 * @public
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 */
 	var ResourceModel = Model.extend("sap.ui.model.resource.ResourceModel", /** @lends sap.ui.model.resource.ResourceModel.prototype */ {
 

package/src/sap/ui/model/type/Boolean.js

@@ -19,7 +19,7 @@ sap.ui.define(['sap/ui/model/SimpleType', 'sap/ui/model/FormatException', 'sap/u
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/Currency.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.CompositeType
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/Date.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getDateInstance DateFormat}.
@@ -215,6 +215,20 @@ sap.ui.define([
 		}
 	};
 
+	/**
+	 * Returns a language-dependent placeholder text such as "e.g. <sample value>" where <sample value> is formatted
+	 * using this type.
+	 *
+	 * @returns {string|undefined}
+	 *   The language-dependent placeholder text or <code>undefined</code> if the type does not offer a placeholder
+	 *
+	 * @experimental As of version 1.114.0
+	 * @public
+	 */
+	Date1.prototype.getPlaceholderText = function () {
+		return this.oOutputFormat.getPlaceholderText();
+	};
+
 	return Date1;
 
 });

package/src/sap/ui/model/type/DateInterval.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.CompositeType
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @alias sap.ui.model.type.DateInterval
 	 * @param {object} [oFormatOptions]
@@ -296,5 +296,19 @@ sap.ui.define([
 		}
 	};
 
+	/**
+	 * Returns a language-dependent placeholder text such as "e.g. <sample value>" where <sample value> is formatted
+	 * using this type.
+	 *
+	 * @returns {string|undefined}
+	 *   The language-dependent placeholder text or <code>undefined</code> if the type does not offer a placeholder
+	 *
+	 * @experimental As of version 1.114.0
+	 * @public
+	 */
+	DateInterval.prototype.getPlaceholderText = function () {
+		return this.oOutputFormat.getPlaceholderText();
+	};
+
 	return DateInterval;
 });

package/src/sap/ui/model/type/DateTime.js

@@ -19,7 +19,7 @@ sap.ui.define(['./Date', 'sap/ui/core/format/DateFormat'],
 	 * @extends sap.ui.model.type.Date
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getDateTimeInstance DateFormat}.

package/src/sap/ui/model/type/DateTimeInterval.js

@@ -19,7 +19,7 @@ sap.ui.define(['./DateInterval', 'sap/ui/core/format/DateFormat'],
 	 * @extends sap.ui.model.type.DateInterval
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getDateTimeInstance DateFormat}.

package/src/sap/ui/model/type/FileSize.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/Float.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/Integer.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/String.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @alias sap.ui.model.type.String
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/Time.js

@@ -19,7 +19,7 @@ sap.ui.define(['./Date', 'sap/ui/core/format/DateFormat'],
 	 * @extends sap.ui.model.type.Date
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getTimeInstance DateFormat}.

package/src/sap/ui/model/type/TimeInterval.js

@@ -19,7 +19,7 @@ sap.ui.define(['./DateInterval', 'sap/ui/core/format/DateFormat'],
 	 * @extends sap.ui.model.type.DateInterval
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getTimeInstance DateFormat}.

package/src/sap/ui/model/type/Unit.js

@@ -48,7 +48,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/xml/XMLModel.js

@@ -47,7 +47,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.ClientModel
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.1
 	 *
 	 * @param {XMLDocument|string} oData
 	 *   Either the URL where to load the XML from or an XML document

package/src/sap/ui/performance/Measurement.js

@@ -178,7 +178,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 * @param {string} sId ID of the measurement
 		 * @param {string} sInfo Info for the measurement
 		 * @param {string | string[]} [aCategories="javascript"] An optional list of categories for the measure
-		 * @return {object} current measurement containing id, info and start-timestamp (false if error)
+		 * @return {module:sap/ui/performance/Measurement.Entry|boolean|undefined} current measurement containing id, info and start-timestamp (false if error)
 		 * @public
 		 * @name module:sap/ui/performance/Measurement.start
 		 * @function
@@ -216,7 +216,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 * Pauses a performance measure.
 		 *
 		 * @param {string} sId ID of the measurement
-		 * @return {object} current measurement containing id, info and start-timestamp, pause-timestamp (false if error)
+		 * @return {module:sap/ui/performance/Measurement.Entry|boolean|undefined} current measurement containing id, info and start-timestamp, pause-timestamp (false if error)
 		 * @public
 		 * @name module:sap/ui/performance/Measurement.pause
 		 * @function
@@ -256,7 +256,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 * Resumes a performance measure.
 		 *
 		 * @param {string} sId ID of the measurement
-		 * @return {object} current measurement containing id, info and start-timestamp, resume-timestamp (false if error)
+		 * @return {module:sap/ui/performance/Measurement.Entry|boolean|undefined} current measurement containing id, info and start-timestamp, resume-timestamp (false if error)
 		 * @public
 		 * @name module:sap/ui/performance/Measurement.resume
 		 * @function
@@ -287,7 +287,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 * Ends a performance measure.
 		 *
 		 * @param {string} sId ID of the measurement
-		 * @return {object} current measurement containing id, info and start-timestamp, end-timestamp, time, duration (false if error)
+		 * @return {module:sap/ui/performance/Measurement.Entry|boolean|undefined} current measurement containing id, info and start-timestamp, end-timestamp, time, duration (false if error)
 		 * @public
 		 * @name module:sap/ui/performance/Measurement.end
 		 * @function
@@ -372,7 +372,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 * @param {int} iTime time in milliseconds
 		 * @param {int} iDuration effective time in milliseconds
 		 * @param {string | string[]} [aCategories="javascript"] An optional list of categories for the measure
-		 * @return {object} [] current measurement containing id, info and start-timestamp, end-timestamp, time, duration, categories (false if error)
+		 * @return {module:sap/ui/performance/Measurement.Entry|boolean|undefined} current measurement containing id, info and start-timestamp, end-timestamp, time, duration, categories (false if error)
 		 * @public
 		 * @name module:sap/ui/performance/Measurement.add
 		 * @function
@@ -406,7 +406,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 * @param {string} sId ID of the measurement
 		 * @param {string} sInfo Info for the measurement
 		 * @param {string | string[]} [aCategories="javascript"] An optional list of categories for the measure
-		 * @return {object} current measurement containing id, info and start-timestamp (false if error)
+		 * @return {module:sap/ui/performance/Measurement.Entry|boolean|undefined} current measurement containing id, info and start-timestamp (false if error)
 		 * @public
 		 * @name module:sap/ui/performance/Measurement.average
 		 * @function
@@ -441,7 +441,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 * Gets a performance measure.
 		 *
 		 * @param {string} sId ID of the measurement
-		 * @return {module:sap/ui/performance/Measurement.Entry} current measurement containing id, info and start-timestamp, end-timestamp, time, duration (false if error)
+		 * @return {module:sap/ui/performance/Measurement.Entry|boolean} current measurement containing id, info and start-timestamp, end-timestamp, time, duration (false if error)
 		 * @public
 		 * @name module:sap/ui/performance/Measurement.getMeasurement
 		 * @function
@@ -466,7 +466,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 * Gets all performance measurements.
 		 *
 		 * @param {boolean} [bCompleted] Whether only completed measurements should be returned, if explicitly set to false only incomplete measurements are returned
-		 * @return {module:sap/ui/performance/Measurement.Entry} current array with measurements containing id, info and start-timestamp, end-timestamp, time, duration, categories
+		 * @return {module:sap/ui/performance/Measurement.Entry[]} current array with measurements containing id, info and start-timestamp, end-timestamp, time, duration, categories
 		 * @public
 		 * @name module:sap/ui/performance/Measurement.getAllMeasurements
 		 * @function
@@ -487,7 +487,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/thirdparty/URI', 'sap/base/util/now'
 		 *     return oMeasurement.duration > 50;
 		 * }</code>
 		 *
-		 * @param {function} [fnFilter] a filter function that returns true if the passed measurement should be added to the result
+		 * @param {function(module:sap/ui/performance/Measurement.Entry)} [fnFilter] a filter function that returns true if the passed measurement should be added to the result
 		 * @param {boolean} [bCompleted] Optional parameter to determine if either completed or incomplete measurements should be returned (both if not set or undefined)
 		 * @param {string[]} [aCategories] The function returns only measurements which match these specified categories
 		 *

package/src/sap/ui/performance/trace/Interaction.js

@@ -50,6 +50,52 @@ sap.ui.define([
 		return str.trim();
 	}
 
+	/**
+	 * The SAP Statistics for OData
+	 *
+	 * @typedef {object} module:sap/ui/performance/trace/Interaction.SAPStatistics
+	 * @public
+	 *
+	 * @property {string} url The url of the response
+	 * @property {string} statistics The response header under the key "sap-statistics"
+	 * @property {PerformanceResourceTiming} timing The last performance resource timing
+	 */
+
+	/**
+	 * Interaction Entry
+	 *
+	 * @typedef {object} module:sap/ui/performance/trace/Interaction.Entry
+	 * @public
+	 *
+	 * @property {string} event The event which triggered the interaction. The default value is "startup".
+	 * @property {string} trigger The control which triggered the interaction.
+	 * @property {string} component The identifier of the component or app that is associated with the
+	 *  interaction.
+	 * @property {string} appVersion The application version as from app descriptor
+	 * @property {float} start The start timestamp of the interaction which is initially set to the
+	 *  <code>fetchStart</code>
+	 * @property {float} end The end timestamp of the interaction
+	 * @property {float} navigation The sum over all navigation times
+	 * @property {float} roundtrip The time from first request sent to last received response end - without
+	 *  gaps and ignored overlap
+	 * @property {float} processing The client processing time
+	 * @property {float} duration The interaction duration
+	 * @property {Array<PerformanceResourceTiming>} requests The Performance API requests during interaction
+	 * @property {Array<module:sap/ui/performance/Measurement.Entry>} measurements The Performance
+	 *  measurements
+	 * @property {Array<module:sap/ui/performance/trace/Interaction.SAPStatistics>} sapStatistics The SAP
+	 *  Statistics for OData
+	 * @property {float} requestTime The sum over all requests in the interaction
+	 * @property {float} networkTime The request time minus server time from the header
+	 * @property {int} bytesSent The sum over all requests bytes
+	 * @property {int} bytesReceived The sum over all responses bytes
+	 * @property {"X"|""} requestCompression It's set with value "X" by default When compression does not
+	 *  match SAP rules, we report an empty string.
+	 * @property {float} busyDuration The sum of the global busy indicator duration during the interaction
+	 * @property {string} id The ID of the interaction
+	 * @property {string} passportAction The default PassportAction for startup
+	 */
+
 	function createMeasurement(iTime) {
 		return {
 			event: "startup", // event which triggered interaction - default is startup interaction
@@ -65,13 +111,13 @@ sap.ui.define([
 			requests: [], // Performance API requests during interaction
 			measurements: [], // Measurements
 			sapStatistics: [], // SAP Statistics for OData
-			requestTime: 0, // summ over all requests in the interaction (oPendingInteraction.requests[0].responseEnd-oPendingInteraction.requests[0].requestStart)
+			requestTime: 0, // sum over all requests in the interaction (oPendingInteraction.requests[0].responseEnd-oPendingInteraction.requests[0].requestStart)
 			networkTime: 0, // request time minus server time from the header
 			bytesSent: 0, // sum over all requests bytes
 			bytesReceived: 0, // sum over all response bytes
 			requestCompression: "X", // ok per default, if compression does not match SAP rules we report an empty string
 			busyDuration: 0, // summed GlobalBusyIndicator duration during this interaction
-			id: uid(), //Interaction id
+			id: uid(), //Interaction ID
 			passportAction: "undetermined_startup_0" //default PassportAction for startup
 		};
 	}
@@ -392,7 +438,7 @@ sap.ui.define([
 	 	 * Gets all interaction measurements.
 		 *
 		 * @param {boolean} bFinalize finalize the current pending interaction so that it is contained in the returned array
-		 * @return {object[]} all interaction measurements
+		 * @return {Array<module:sap/ui/performance/trace/Interaction.Entry>} all interaction measurements
 		 *
 		 * @static
 		 * @public
@@ -415,7 +461,7 @@ sap.ui.define([
 		 *     return InteractionMeasurement.duration > 0
 		 * }</code>
 		 * @param {function} fnFilter a filter function that returns true if the passed measurement should be added to the result
-		 * @return {object[]} all interaction measurements passing the filter function successfully
+		 * @return {Array<module:sap/ui/performance/trace/Interaction.Entry>} all interaction measurements passing the filter function successfully
 		 *
 		 * @static
 		 * @public

package/src/sap/ui/performance/trace/initTraces.js

@@ -10,8 +10,8 @@
 sap.ui.define([
 	"sap/ui/performance/trace/FESR",
 	"sap/base/Log",
-	"sap/base/util/UriParameters"
-], function(FESR, Log, UriParameters) {
+	"sap/base/config"
+], function(FESR, Log, BaseConfig) {
 
 	"use strict";
 
@@ -25,16 +25,18 @@ sap.ui.define([
 	 * @ui5-restricted sap.ui.core
 	 */
 	return function() {
-		var oFESRMeta = document.querySelector("meta[name=sap-ui-fesr]"),
-			sFESRMetaContent = oFESRMeta ? oFESRMeta.getAttribute("content") : undefined,
-			bActive =  !!sFESRMetaContent && sFESRMetaContent !== "false",
-			sUriParam = UriParameters.fromQuery(window.location.search).get("sap-ui-fesr"),
-			sUrl = sFESRMetaContent && sFESRMetaContent !== "true" ? sFESRMetaContent : undefined;
+		var sUrl,
+			bActive = false,
+			sFesr = BaseConfig.get({
+				name: "sapUiFesr",
+				type: BaseConfig.Type.String,
+				external: true,
+				freeze: true
+			});
 
-		if (sUriParam) {
-			bActive = sUriParam != "false";
-			// FESR Definition via URL wins over meta
-			sUrl = ["true", "false", "x", "X", undefined].indexOf(sUriParam) === -1 ? sUriParam : sUrl;
+		if (sFesr) {
+			bActive = sFesr != "false";
+			sUrl = ["true", "false", "x", "X", undefined].indexOf(sFesr) === -1 ? sFesr : undefined;
 		}
 
 		if (typeof window.performance.getEntriesByType === "function") {
@@ -43,10 +45,14 @@ sap.ui.define([
 			Log.debug("FESR is not supported in clients without support of window.Performance extensions.");
 		}
 
-		// TODO this should be part of a Configuration
 		// *********** Include E2E-Trace Scripts *************
-		if (/sap-ui-xx-e2e-trace=(true|x|X)/.test(location.search)) {
+		if (BaseConfig.get({
+			name: "sapUiXxE2eTrace",
+			type: BaseConfig.Type.Boolean,
+			external: true,
+			freeze: true
+		})) {
 			sap.ui.require(["sap/ui/core/support/trace/E2eTraceLib"]);
 		}
 	};
-});
+});