@openui5/sap.ui.core
Version:
OpenUI5 Core Library sap.ui.core
64 lines (62 loc) • 1.81 kB
JavaScript
/*!
* OpenUI5
* (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
* Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
*/
sap.ui.define(["./_merge"], function(_merge) {
"use strict";
/**
* Performs object extension by merging source objects into a target object. Copies are always deep.
*
* If during merging a key in the target object exists it is overwritten with the source object's value.
* Usage is the same as <code>jQuery.extend(true, ...)</code>.
* Values that are <code>undefined</code> are ignored.
*
* For shallow copies, you may use {@link module:sap/base/util/extend sap/base/util/extend} or
* <code>Object.assign</code>, but note that <code>Object.assign</code> only copies enumerable and own
* properties and doesn't copy properties on the prototype and non-enumerable properties.
* Also, values that are <code>undefined</code> are NOT ignored.
*
* @example
* var oResult = deepExtend({}, {
* prop1: {
* prop1a: "1a"
* }
* }, {
* prop2: {
* prop2a: "2a"
* }
* }, {
* prop1: {
* prop1b: "1b"
* }
* }, {
* prop2: undefined
* });
*
* console.log(oResult);
* {
* "prop1": {
* "prop1a": "1a",
* "prop1b": "1b"
* },
* "prop2": {
* "prop2a": "2a"
* }
* }
*
* @function
* @alias module:sap/base/util/deepExtend
* @param {object} target The object that will receive new properties
* @param {...object} [source] One or more objects which get merged into the target object
* @return {object} the target object which is the result of the merge
* @public
* @since 1.71
*/
var fnDeepExtend = function() {
var args = [true, true];
args.push.apply(args, arguments);
return _merge.apply(null, args);
};
return fnDeepExtend;
});