@openui5/sap.ui.core 1.103.1 → 1.106.0

package/src/sap/base/util/fetch.js

@@ -0,0 +1,228 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([], function () {
+	"use strict";
+
+	function parseHeaders(sAllResponseHeaders) {
+		var result = new Headers();
+		sAllResponseHeaders.trim().split("\r\n").forEach(function (sHeader) {
+			if (sHeader) {
+				var pos = sHeader.indexOf(": ");
+				if (pos > 0) {
+					result.append(sHeader.slice(0, pos), sHeader.slice(pos + 2));
+				} else {
+					result.append(sHeader, "");
+				}
+			}
+		});
+		return result;
+	}
+
+	/**
+	 * Represents the response object to a {@link module:sap/base/util/fetch} request and {@link module:sap/base/util/syncFetch} request.
+	 * The implementation is based on the Response interface of the global <code>fetch()</code> method,
+	 * but brings a much reduced set of properties and methods.
+	 *
+	 * The properties that are provided:
+	 * <ul>
+	 * 	<li>The <code>headers</code> property containing the <code>Headers</code> object</li>
+	 * 	<li>The <code>ok</code> property containing a boolean stating whether the response was successful</li>
+	 * 	<li>The <code>status</code> property containing the HTTP status code</li>
+	 * 	<li>The <code>statusText</code> property containing an HTTP status message</li>
+	 * </ul>
+	 *
+	 * The methods that are provided:
+	 * <ul>
+	 * 	<li>The <code>json()</code> method returns a promise that resolves with the result of parsing the XHR response text as JSON</li>
+	 * 	<li>The <code>text()</code> method returns a promise that resolves with the XHR response text as String</li>
+	 * </ul>
+	 *
+	 * In case of a response to a synchronous <code>sap.base.util.syncFetch</code> request,
+	 * all methods will return the XHR response directly, according to the respective output format.
+	 *
+	 *
+	 * @param {XMLHttpRequest} xhr The XMLHttpRequest object
+	 * @param {Promise|sap.ui.base.SyncPromise} PromiseImpl A Promise for asynchronous requests, and
+	 *                                          an <code>sap.ui.base.SyncPromise</code> for synchronous requests.
+	 * @interface
+	 * @alias sap.base.util.SimpleResponse
+	 * @private
+	 * @ui5-restricted SAPUI5 Dist
+	 */
+	function SimpleResponse(xhr, PromiseImpl) {
+		var headers = parseHeaders(xhr.getAllResponseHeaders());
+		Object.defineProperties(this, {
+			headers: {
+				value: headers
+			},
+			ok: {
+				value: xhr.status >= 200 && xhr.status < 300
+			},
+			status: {
+				value: xhr.status
+			},
+			statusText: {
+				value: xhr.statusText
+			}
+		});
+
+		this.json = function() {
+			if (xhr.responseType === "json") {
+				return PromiseImpl.resolve(xhr.response);
+			} else {
+				try {
+					var oData = JSON.parse(xhr.responseText);
+					return PromiseImpl.resolve(oData);
+				} catch (err) {
+					return PromiseImpl.reject(err);
+				}
+			}
+		};
+
+		this.text = function() {
+			return PromiseImpl.resolve(xhr.responseText);
+		};
+	}
+
+	// Allowed request credentials
+	var ALLOWED_CREDENTIALS = ["include", "omit", "same-origin"];
+
+	/**
+	 * Performs an asynchronous XMLHttpRequest (XHR) with the provided resource URL and request settings.
+	 * It returns a Promise that resolves with an <code>sap.base.util.SimpleResponse</code> object, which is
+	 * a simplified implementation of the global Response interface, representing the response of the XHR.
+	 *
+	 * If the request encounters network failures, the returned promise will be rejected with a <code>TypeError</code>.
+	 * In case of an HTTP error status (e.g. error status 404), the returned promise will resolve instead.
+	 * The <code>response.ok</code> or <code>response.status</code> flags can be used to distinguish
+	 * a success status from an error status.
+	 *
+	 * The Promise will reject with a <code>DOMException</code> if the request gets aborted.
+	 * To abort a request, an instance of the global <code>AbortSignal</code> must be provided to the settings via property <code>init.signal</code>.
+	 * An abort signal can be created via an instance of the <code>AbortController</code>, and then using
+	 * the <code>AbortController.signal</code> property. The signal associates the abort controller with the request
+	 * and allows it to abort the XHR by calling <code>AbortController.abort()</code>.
+	 *
+	 * Although the usage of this method is very similar to the native <code>fetch()</code> method,
+	 * it allows a much reduced set of request settings (in the <code>init</code> argument).
+	 *
+	 * @param  {string} resource A string containing the URL to which the request is sent
+	 * @param  {object} [init] A set of key/value pairs that configure the request.
+	 * @param  {any} [init.body] Any body that you want to add to your request: this can be a Blob, BufferSource, FormData, URLSearchParams, string, or ReadableStream object.
+	 *                           Note that a request using the GET or HEAD method cannot have a body.
+	 * @param  {"omit"|"same-origin"|"include"} [init.credentials='same-origin'] Controls what browsers do with credentials.
+	 *                                                   Must be either 'omit', 'same-origin' or 'include'.
+	 * @param  {Headers|object} [init.headers] A Headers object or an object with key/value pairs containing the request headers
+	 * @param  {string} [init.method='GET'] The request method, e.g. 'GET', 'POST'
+	 * @param  {AbortSignal} [init.signal] An AbortSignal object instance which allows to abort the request
+	 * @return {Promise<sap.base.util.SimpleResponse>} Returns a Promise resolving with <code>sap.base.util.SimpleResponse</code>
+	 *
+	 * @alias module:sap/base/util/fetch
+	 * @private
+	 * @ui5-restricted SAPUI5 Dist
+	 */
+	function fetch(resource, init, _mImplementations) {
+		/**
+		 * see "https://developer.mozilla.org/en-US/docs/Web/API/Request/Request"
+		 * regarding default values
+		 */
+		init = Object.assign({
+			body: null,
+			credentials: "same-origin",
+			method: "GET",
+			signal: new AbortController().signal
+			// mode: "cors",
+			// redirect: "follow",
+			// referrer: "about:client"
+		}, init);
+
+		// "sap/base/util/syncFetch" might pass a SyncPromise implementation
+		var PromiseImpl = (_mImplementations && _mImplementations.promiseImpl) || Promise;
+
+		return new PromiseImpl(function(resolve, reject) {
+			// check for credentials in the resource URL
+			var oUrl = new URL(resource, document.baseURI);
+			if (oUrl.username || oUrl.password) {
+				reject(new TypeError("Failed to execute 'fetch': Request cannot be constructed from a URL that includes credentials:" + resource));
+			}
+
+			if (init.body !== null && (init.method == "GET" || init.method == "HEAD")) {
+				reject(new TypeError("Failed to execute 'fetch': Request with GET/HEAD method cannot have body."));
+			}
+
+			var xhr = new XMLHttpRequest();
+			// event listener
+			xhr.addEventListener("load", function() {
+				var oResponse = new SimpleResponse(xhr, PromiseImpl);
+
+				if (_mImplementations && _mImplementations.responseMixin) {
+					_mImplementations.responseMixin.apply(oResponse);
+				}
+				resolve(oResponse);
+			});
+			xhr.addEventListener("error", function() {
+				reject(new TypeError("Failed to fetch."));
+			});
+
+			xhr.open(init.method, resource, _mImplementations ? false : true);
+
+			// see https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort
+			init.signal.addEventListener("abort", function () {
+				xhr.abort();
+				reject(new DOMException("The user aborted a request.", "AbortError"));
+			});
+
+			// set request headers
+			var oHeaders;
+			if (init.headers instanceof Headers) {
+				oHeaders = Object.fromEntries(init.headers);
+			} else {
+				oHeaders = init.headers || {};
+			}
+			Object.keys(oHeaders).forEach(function(key) {
+				xhr.setRequestHeader(key, oHeaders[key]);
+			});
+
+			// request credentials
+			if (ALLOWED_CREDENTIALS.includes(init.credentials)) {
+				// set credentials
+				if (init.credentials === "omit") {
+					xhr.withCredentials = false;
+				} else if (init.credentials === "include") {
+					xhr.withCredentials = true;
+				}
+			} else {
+				reject(new TypeError("Failed to execute 'fetch': Failed to read the 'credentials' property from 'RequestInit': The provided value " + init.credentials
+					+ " is not a valid enum value of type RequestCredentials."));
+			}
+
+			// send request
+			try {
+				xhr.send(init.body);
+			} catch (error) {
+				reject(new TypeError(error.message));
+			}
+		});
+	}
+
+	/**
+	 * Header values that can be used with the "Accept" and "Content-Type" headers
+	 * in the fetch call or the response object.
+	 *
+	 * @type {Object}
+	 * @private
+	 * @ui5-restricted SAPUI5 Dist
+	 *
+	 */
+	fetch.ContentTypes = {
+		TEXT: "text/plain",
+		HTML: "text/html",
+		XML: "application/xml, text/xml",
+		JSON: "application/json, text/javascript"
+	};
+
+	return fetch;
+});

package/src/sap/base/util/mixedFetch.js

@@ -0,0 +1,69 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+	"./fetch",
+	"sap/ui/base/SyncPromise"
+], function (fetch, SyncPromise) {
+	"use strict";
+
+	/**
+	 * Allows to perform an synchronous or asynchronous XMLHttpRequest (XHR) with the provided resource URL and request settings.
+	 * It returns a Promise resolving with an <code>sap.base.util.SimpleResponse</code> object, which is
+	 * a simplified implementation of the global Response interface, representing the response of the XHR.
+	 * It returns a <code>sap.ui.base.SyncPromise</code>, if the property <code>init.sync</code> is set to 'true'.
+	 *
+	 * If the request encounters network failures, the returned promise will be rejected with a <code>TypeError</code>.
+	 * In case of an HTTP error status (e.g. error status 404), the returned promise will resolve instead. The properties
+	 * <code>response.ok</code> or <code>response.status</code> can be used to distinguish
+	 * a success status from an error status.
+	 *
+	 * The Promise or SyncPromise will reject with a <code>DOMException</code> if the request gets aborted.
+	 * To abort a request, an instance of the global <code>AbortSignal</code> must be provided to the settings.
+	 * An abort signal can be created via an instance of the <code>AbortController</code>, and then using
+	 * the <code>AbortController.signal</code> property. The signal associates the abort controller with the request
+	 * and allows it to abort the XHR by calling <code>AbortController.abort()</code>.
+	 *
+	 * @param  {string} resource A string containing the URL to which the request is sent
+	 * @param  {object} [init] A set of key/value pairs that configure the request.
+	 * @param  {any} [init.body] Any body that you want to add to your request: this can be a Blob, BufferSource, FormData, URLSearchParams, string, or ReadableStream object.
+	 *                           Note that a request using the GET or HEAD method cannot have a body.
+	 * @param  {"omit"|"same-origin"|"include"} [init.credentials='same-origin'] Controls what browsers do with credentials.
+	 *                                                                           Must be either 'omit', 'same-origin' or 'include'.
+	 * @param  {Headers|object} [init.headers] A Headers object or an object with key/value pairs containing the request headers
+	 * @param  {string} [init.method='GET'] The request method, e.g. 'GET', 'POST'
+	 * @param  {AbortSignal} [init.signal] An AbortSignal object instance which allows to abort the request
+	 * @param  {boolean} [bSync=false] Performs a synchronous XMLHttpRequest if set to 'true'
+	 * @return {Promise<sap.base.util.SimpleResponse>|sap.ui.base.SyncPromise<sap.base.util.SimpleResponse>} Returns a Promise or SyncPromise resolving with an <code>sap.base.util.SimpleResponse</code> object
+	 *
+	 * @alias module:sap/base/util/mixedFetch
+	 * @private
+	 * @ui5-restricted sap.ui.core, sap.ui.model
+	 */
+	function mixedFetch(resource, init, bSync) {
+		var mImplementations;
+
+		if (bSync === true) {
+			mImplementations = {
+				promiseImpl: SyncPromise
+			};
+		}
+
+		return fetch(resource, init, mImplementations);
+	}
+
+	/**
+	 * Header values that can be used with the "Accept" and "Content-Type" headers
+	 * in the fetch call or the response object.
+	 *
+	 * @type {Object}
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 *
+	 */
+	mixedFetch.ContentTypes = fetch.ContentTypes;
+
+	return mixedFetch;
+});

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

@@ -26,7 +26,7 @@
  * @alias module:sap/base/util/restricted/_CancelablePromise
  * @author SAP SE
  * @since 1.79
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_castArray
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_compact
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_curry
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_debounce
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_difference
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_differenceBy
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_differenceWith
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flatMap
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flatMapDeep
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flatMapDepth
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flatten
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flattenDeep
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flattenDepth
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_intersection
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_intersectionBy
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_intersectionWith
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_isEqual
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_isEqualWith
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_isNil
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_max
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_merge
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_mergeWith
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_min
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_omit
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_pick
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_pickBy
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_throttle
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_toArray
  * @author SAP SE
  * @since 1.80
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_union
  * @author SAP SE
  * @since 1.81
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_unionBy
  * @author SAP SE
  * @since 1.81
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_unionWith
  * @author SAP SE
  * @since 1.81
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_uniq
  * @author SAP SE
  * @since 1.71
- * @version 1.103.1
+ * @version 1.106.0
  * @private
  * @ui5-restricted
 */

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

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

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

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

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

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