@ui5/webcomponents-localization/dist/sap/base/util/extend.js

Localization for UI5 Web Components

/*!
 * OpenUI5
 * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
 * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
 */
import _merge from "./_merge.js";
/**
 * Performs object extension by merging source objects into a target object. Generates a shallow copy.
 *
 * 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(...)</code>.
 * Values that are <code>undefined</code> are ignored.
 *
 * As alternative you may also use <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.
 *
 * For deep copies, you may use {@link module:sap/base/util/deepExtend sap/base/util/deepExtend}.
 *
 * @example
 * var oResult = extend({}, {
 *   prop1: {
 *     prop1a: "1a"
 *   }
 * }, {
 *   prop2: {
 *     prop2a: "2a"
 *   }
 * }, {
 *   prop1: {
 *      prop1b: "1b"
 *   }
 * }, {
 *   prop2: undefined
 * });
 *
 *
 * console.log(oResult);
 * {
 *   "prop1": {
 *     "prop1b": "1b"
 *   },
 *   "prop2": {
 *     "prop2a": "2a"
 *   }
 * }
 *
 * @function
 * @alias module:sap/base/util/extend
 * @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 fnExtend = function () {
  var args = [false, true];
  args.push.apply(args, arguments);
  return _merge.apply(null, args);
};
export default fnExtend;