@openui5/sap.ui.core 1.112.2 → 1.114.0

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.112.2
+	 * @version 1.114.0
 	 *
 	 * @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"]);
 		}
 	};
-});
+});

package/src/sap/ui/qunit/qunit-coverage-istanbul.js

@@ -0,0 +1,180 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+/* global QUnit */
+(function() {
+	"use strict";
+
+	if (typeof QUnit === "undefined") {
+		throw new Error("qunit-coverage-istanbul.js: QUnit is not loaded yet!");
+	}
+
+	// Functions taken from blanket.js - v1.1.5 (sap/ui/thirdparty/blanket.js)
+	// BEGIN: Copy from blanket.js
+	function normalizeBackslashes(str) {
+		return str.replace(/\\/g, '/');
+	}
+	function matchPatternAttribute(filename,pattern){
+		if (typeof pattern === 'string'){
+			if (pattern.indexOf("[") === 0){
+				//treat as array
+				var pattenArr = pattern.slice(1,pattern.length - 1).split(",");
+				return pattenArr.some(function(elem){
+					return matchPatternAttribute(filename,normalizeBackslashes(elem.slice(1,-1)));
+				});
+			} else if ( pattern.indexOf("//") === 0){
+				var ex = pattern.slice(2,pattern.lastIndexOf('/'));
+				var mods = pattern.slice(pattern.lastIndexOf('/') + 1);
+				var regex = new RegExp(ex,mods);
+				return regex.test(filename);
+			} else if (pattern.indexOf("#") === 0){
+				return window[pattern.slice(1)].call(window,filename);
+			} else {
+				return filename.indexOf(normalizeBackslashes(pattern)) > -1;
+			}
+		} else if ( pattern instanceof Array ){
+			return pattern.some(function(elem){
+				return matchPatternAttribute(filename,elem);
+			});
+		} else if (pattern instanceof RegExp){
+			return pattern.test(filename);
+		} else if (typeof pattern === "function"){
+			return pattern.call(window,filename);
+		}
+	}
+	// END: Copy from blanket.js
+
+	// set a hook for client-side coverage on window object
+	window["sap-ui-qunit-coverage"] = "client";
+
+	// client-side instrument filter options (data-attributes of qunit-coverage-istanbul script tag)
+	var filters;
+	var oScript = document.currentScript;
+	function getFilters() {
+		var sFilterAttr, sAntiFilterAttr;
+
+		// Cache and only read once
+		if (filters) {
+			return filters;
+		}
+
+		if (oScript) {
+			// Set custom client-side instrument filter (from script attributes)
+			if (oScript.hasAttribute("data-sap-ui-cover-only")) {
+				sFilterAttr = oScript.getAttribute("data-sap-ui-cover-only");
+			}
+			if (oScript.hasAttribute("data-sap-ui-cover-never")) {
+				sAntiFilterAttr = oScript.getAttribute("data-sap-ui-cover-never");
+			}
+		}
+
+		filters = {filter: sFilterAttr, antiFilter: sAntiFilterAttr};
+		return filters;
+	}
+
+	function shouldBeInstrumented(sModuleName) {
+		var appliedFilters = getFilters(),
+			sFilterAttr = appliedFilters.filter,
+			sAntiFilterAttr = appliedFilters.antiFilter;
+
+		if (typeof sAntiFilterAttr !== "undefined" && matchPatternAttribute(sModuleName, sAntiFilterAttr)) {
+			// NEVER INSTRUMENT (excluded)
+			return false;
+		} else if (typeof sFilterAttr === "undefined" || matchPatternAttribute(sModuleName, sFilterAttr)) {
+			// INSTRUMENT (included)
+			return true;
+		} else {
+			// DONT INSTRUMENT (not explicitly excluded / included)
+			return false;
+		}
+	}
+
+	function appendUrlParameter(sUrl) {
+		var oUrl = new URL(sUrl, document.baseURI);
+		oUrl.searchParams.set("instrument", "true");
+		return oUrl.toString();
+	}
+
+	// check for coverage being active or not
+	if (QUnit.urlParams.coverage) {
+
+		var fnSetAttributeOrig = HTMLScriptElement.prototype.setAttribute;
+		HTMLScriptElement.prototype.setAttribute = function(sName, sValue) {
+			if (sName === "data-sap-ui-module" && shouldBeInstrumented(sValue || "")) {
+				this.src = appendUrlParameter(this.src);
+			}
+			fnSetAttributeOrig.apply(this, arguments);
+		};
+
+		var fnXhrOpenOrig = XMLHttpRequest.prototype.open;
+		XMLHttpRequest.prototype.open = function(sMethod, sUrl) {
+			if (
+				typeof sap !== "undefined" && sap.ui && sap.ui.loader &&
+				sUrl && sUrl.endsWith(".js") && shouldBeInstrumented(sap.ui.loader._.guessResourceName(sUrl) || "")
+			) {
+				arguments[1] = appendUrlParameter(sUrl);
+			}
+			fnXhrOpenOrig.apply(this, arguments);
+		};
+
+		// Build the layout
+		QUnit.done(function () {
+			// Do not try to create a report when the page is embed into an IFrame
+			// The IFrame has the coverage data and could handle it on its own
+			if (window.top !== window){
+				return;
+			}
+			sap.ui.require(["sap/base/util/fetch"], function (fetch) {
+				fetch("/.ui5/coverage/report", {
+					method: "POST",
+					body: JSON.stringify(window.top.__coverage__),
+					headers: {
+						"Content-Type": "application/json"
+					}
+				})
+				.then(function (pResponse) {
+					return pResponse.json();
+				})
+				.then(function (oData) {
+					var aReports = oData.availableReports;
+					var oHTMLReport = aReports.filter(function (oCurReport) {
+						// HTML is the only one that make sense and
+						// provides understandable information
+						return oCurReport.report === "html";
+					})[0];
+
+					if (!oHTMLReport) { // Do not render reports if HTML or lcov are not provided
+						return;
+					}
+
+					var body = document.body;
+					var oFrameEl = document.createElement("iframe");
+					oFrameEl.src = "/.ui5/coverage/report/" + oHTMLReport.destination;
+					oFrameEl.style.border = "none";
+					oFrameEl.style.width = "100%";
+					oFrameEl.style.height = "100vh";
+					oFrameEl.sandbox = "allow-scripts";
+
+					body.appendChild(oFrameEl);
+				});
+			});
+		});
+	}
+
+	// add a QUnit configuration option in the Toolbar to enable/disable
+	// client-side instrumentation (done manually because there might be a
+	// case where the setup does not use _setupAndStart.js)
+	var bHasCoverageCheckbox = QUnit.config.urlConfig.some(function (oConf) {
+		return oConf.id === "coverage";
+	});
+
+	if (!bHasCoverageCheckbox) {
+		QUnit.config.urlConfig.push({
+			id: "coverage",
+			label: "Enable coverage",
+			tooltip: "Enable code coverage."
+		});
+	}
+})();

package/src/sap/ui/qunit/qunit-coverage.js

@@ -132,12 +132,17 @@
 		// add a QUnit configuration option in the Toolbar to enable/disable
 		// client-side instrumentation via blanket (done manually because in
 		// this case blanket will not be loaded and executed)
-		QUnit.config.urlConfig.push({
-			id: "coverage",
-			label: "Enable coverage",
-			tooltip: "Enable code coverage."
+		var bHasCoverageCheckbox = QUnit.config.urlConfig.some(function (oConf) {
+			return oConf.id === "coverage";
 		});
 
+		if (!bHasCoverageCheckbox) {
+			QUnit.config.urlConfig.push({
+				id: "coverage",
+				label: "Enable coverage",
+				tooltip: "Enable code coverage."
+			});
+		}
 	}
 
 })();

package/src/sap/ui/qunit/utils/ControlIterator.js

@@ -53,7 +53,7 @@ sap.ui.define(['sap/ui/core/Core', "sap/ui/VersionInfo"],
 	 * @namespace
 	 *
 	 * @author SAP SE
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 *
 	 * @public
 	 * @since 1.48.0

package/src/sap/ui/qunit/utils/MemoryLeakCheck.js

@@ -27,7 +27,7 @@ sap.ui.define([ 'sap/ui/core/Element', 'sap/ui/core/Control', 'sap/ui/core/Core'
 	 * @namespace
 	 *
 	 * @author SAP SE
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 *
 	 * @public
 	 * @since 1.48.0

package/src/sap/ui/test/Opa.js

@@ -213,10 +213,57 @@ sap.ui.define([
 		$.extend(this, extensionObject);
 	};
 
+	/**
+	 * @typedef {object} sap.ui.test.Opa.BaseParameters
+	 * @description Configuration parameters for Opa.
+	 * @property {int} [timeout=15] (seconds) Specifies how long the waitFor function polls before it fails. The default value is 15 seconds, 0 means it will wait forever.
+	 * @property {int} [debugTimeout=0] (seconds) @since 1.47 Specifies how long the waitFor function polls before it fails in debug mode. 0 means it will wait forever.
+	 * @property {int} [pollingInterval=400] (milliseconds) Specifies how often the waitFor function polls. The default is 400ms.
+	 * @property {boolean} [asyncPolling=false] @since 1.55 Enable asynchronous polling after success() call. This allows more stable autoWaiter synchronization with event flows originating from within success(). Especially useful to stabilize synchronization with overflow toolbars. False by default.
+	 * @public
+	 */
+
+	/**
+	 * @typedef {sap.ui.test.Opa.BaseParameters} sap.ui.test.Opa.Config
+	 * @description The global configuration of Opa.
+	 * @property {sap.ui.test.Opa} [arrangements] A new Opa instance
+	 * @property {sap.ui.test.Opa} [actions] A new Opa instance
+	 * @property {sap.ui.test.Opa} [assertions] A new Opa instance
+	 * @property {int} [executionDelay] The value is a number representing milliseconds. The default values are 0 or 50 (depending on the browser).
+	 * The executionDelay will slow down the execution of every single waitFor statement to be delayed by the number of milliseconds.
+	 * This does not effect the polling interval it just adds an initial pause.
+	 * Use this parameter to slow down OPA when you want to watch your test during development or checking the UI of your app.
+	 * It is not recommended to use this parameter in any automated test executions.
+	 * @public
+	 */
+
+	/**
+	 * @typedef {sap.ui.test.Opa.BaseParameters} sap.ui.test.Opa.WaitForOptions
+	 * @description Configuration parameters for an individual {@link sap.ui.test.Opa#waitFor} call.
+	 * @property {function(any):boolean} [check] Will get invoked in every polling interval.
+	 * If it returns true, the check is successful and the polling will stop.
+	 * The first parameter passed into the function is the same value that gets passed to the success function.
+	 * Returning something other than boolean in the check will not change the first parameter of success.
+	 * @property {function} [success] Will get invoked after the check function returns true.
+	 * If there is no check function defined, it will be directly invoked.
+	 * waitFor statements added in the success handler will be executed before previously added waitFor statements.
+	 * @property {string} [errorMessage] Will be displayed as an errorMessage depending on your unit test framework.
+	 * Currently the only adapter for Opa is QUnit.
+	 * This message is displayed there if Opa has reached its timeout but QUnit has not yet reached it.
+	 * @public
+	 */
+
+	/**
+	 * @typedef {sap.ui.test.Opa} sap.ui.test.Opa.Chain
+	 * @description Used as return value of the {@link sap.ui.test.Opa#waitFor} to assist chaining
+	 * @property {sap.ui.test.Opa} and A reference to the same <code>sap.ui.test.Opa</code> instance that can be used for chaining statements
+	 * @public
+	 */
+
 	/**
 	 * The global configuration of Opa.
-	 * All of the global values can be overwritten in an individual <code>waitFor</code> call.
-	 * The default values are:
+	 * The subset of the global values defined in {@link sap.ui.test.Opa.BaseParameters}.can be overwritten in an individual <code>waitFor</code> call.
+	 * The default values for the global configuration are:
 	 * <ul>
 	 * 		<li>arrangements: A new Opa instance</li>
 	 * 		<li>actions: A new Opa instance</li>
@@ -227,6 +274,7 @@ sap.ui.define([
 	 * 		<li>asyncPolling: false</li>
 	 * </ul>
 	 * You can either directly manipulate the config, or extend it using {@link sap.ui.test.Opa.extendConfig}.
+	 * @type sap.ui.test.Opa.Config
 	 * @public
 	 */
 	Opa.config = {};
@@ -292,7 +340,7 @@ sap.ui.define([
 	 * @since 1.48 All config parameters could be overwritten from URL. Should be prefixed with 'opa'
 	 * and have uppercase first character. Like 'opaExecutionDelay=1000' will overwrite 'executionDelay'
 	 *
-	 * @param {object} options The values to be added to the existing config
+	 * @param {sap.ui.test.Opa.Config} options The values to be added to the existing config
 	 * @public
 	 */
 	Opa.extendConfig = function (oOptions) {
@@ -387,7 +435,7 @@ sap.ui.define([
 	 * Gives access to a singleton object you can save values in.
 	 * Same as {@link sap.ui.test.Opa#getContext}
 	 * @since 1.29.0
-	 * @returns {object} the context object
+	 * @returns {Object<string,any>} the context object
 	 * @public
 	 * @function
 	 */
@@ -509,23 +557,8 @@ sap.ui.define([
 		 *
 		 *
 		 * @public
-		 * @param {object} options These contain check, success and error functions
-		 * @param {int} [options.timeout] default: 15 - (seconds) Specifies how long the waitFor function polls before it fails.O means it will wait forever.
-		 * @param {int} [options.debugTimeout] @since 1.47 default: 0 - (seconds) Specifies how long the waitFor function polls before it fails in debug mode.O means it will wait forever.
-		 * @param {int} [options.pollingInterval] default: 400 - (milliseconds) Specifies how often the waitFor function polls.
-		 * @param {boolean} [options.asyncPolling] @since 1.55 default: false Enable asynchronous polling after success() call. This allows more stable autoWaiter synchronization with event flows originating from within success(). Especially usefull to stabilize synchronization with overflow toolbars.
-		 * @param {function} [options.check] Will get invoked in every polling interval.
-		 * If it returns true, the check is successful and the polling will stop.
-		 * The first parameter passed into the function is the same value that gets passed to the success function.
-		 * Returning something other than boolean in the check will not change the first parameter of success.
-		 * @param {function} [options.success] Will get invoked after the check function returns true.
-		 * If there is no check function defined, it will be directly invoked.
-		 * waitFor statements added in the success handler will be executed before previously added waitFor statements.
-		 * @param {string} [options.errorMessage] Will be displayed as an errorMessage depending on your unit test framework.
-		 * Currently the only adapter for Opa is QUnit.
-		 * This message is displayed there if Opa has reached its timeout but QUnit has not yet reached it.
-		 *
-		 * @returns {object} an object extending a jQuery promise.
+		 * @param {sap.ui.test.Opa.WaitForOptions} options configuration options
+		 * @returns {sap.ui.test.Opa.Chain} an object extending a jQuery promise.
 		 * The object is essentially a jQuery promise with an additional "and" method that can be used for chaining waitFor statements.
 		 * The promise is resolved when the waitFor completes successfully.
 		 * The promise is rejected with the options object, if an error occurs. In this case, options.errorMessage will contain a detailed error message containing the stack trace and Opa logs.