49 lines
2.3 KiB
JavaScript
49 lines
2.3 KiB
JavaScript
import { isEqualsSameValueZero } from "../../_internal/isEqualsSameValueZero.mjs";
|
|
import "../util/eq.mjs";
|
|
import { keys } from "./keys.mjs";
|
|
//#region src/compat/object/assignWith.ts
|
|
/**
|
|
* Assigns properties from multiple source objects to a target object.
|
|
* You can provide a `getValueToAssign` function to determine what value will be assigned for each property.
|
|
*
|
|
* This function merges the properties of the source objects into the target object.
|
|
* If a property in the source objects is equal to the corresponding property in the target object,
|
|
* it will not be overwritten.
|
|
*
|
|
* Unlike `assign`, this method accepts a `getValueToAssign` function that determines
|
|
* the final value to be assigned to each property in the target object. The return value
|
|
* of this function will be directly assigned to the corresponding property. This allows for
|
|
* more precise control over how properties are merged between objects. If not provided,
|
|
* the default behavior is equivalent to using the identity function (returning the source value).
|
|
*
|
|
* @param {any} object - The target object to which properties will be assigned.
|
|
* @param {...any[]} sources - The source objects whose properties will be assigned to the target object.
|
|
* @returns {any} The updated target object with properties from the source objects assigned.
|
|
*
|
|
* @example
|
|
* const target = { a: 1 };
|
|
* const result = assignWith(target, { b: 2 }, { c: 3 }, function(objValue, srcValue) {
|
|
* return objValue === undefined ? srcValue : objValue;
|
|
* });
|
|
* console.log(result); // Output: { a: 1, b: 2, c: 3 }
|
|
*/
|
|
function assignWith(object, ...sources) {
|
|
let getValueToAssign = sources[sources.length - 1];
|
|
if (typeof getValueToAssign === "function") sources.pop();
|
|
else getValueToAssign = void 0;
|
|
for (let i = 0; i < sources.length; i++) assignWithImpl(object, sources[i], getValueToAssign);
|
|
return object;
|
|
}
|
|
function assignWithImpl(object, source, getValueToAssign) {
|
|
const keys$1 = keys(source);
|
|
for (let i = 0; i < keys$1.length; i++) {
|
|
const key = keys$1[i];
|
|
const objValue = object[key];
|
|
const srcValue = source[key];
|
|
const newValue = getValueToAssign?.(objValue, srcValue, key, object, source) ?? srcValue;
|
|
if (!(key in object) || !isEqualsSameValueZero(objValue, newValue)) object[key] = newValue;
|
|
}
|
|
}
|
|
//#endregion
|
|
export { assignWith };
|