@gvray/eskit/lib/extendDeep.js

A rich and colorful toolkit about typescript and javascript.

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
var hasOwnProperty_1 = __importDefault(require("./hasOwnProperty"));
var isArray_1 = __importDefault(require("./isArray"));
/**
 * Recursively extends an object by deeply copying properties from parent to child.
 * 通过将属性从父对象深度复制到子对象来递归扩展对象。
 *
 * @param parent - The parent object to copy from / 要复制的父对象
 * @param child - The child object to merge into / 要合并到的子对象
 * @returns The extended child object / 扩展后的子对象
 *
 * @example
 * ```typescript
 * const parent = {
 *   a: { b: 1, c: 2 },
 *   d: [1, 2, 3],
 *   e: 'hello'
 * }
 * const child = { a: { c: 3, f: 4 } }
 *
 * const result = extendDeep(parent, child)
 * console.log(result)
 * // {
 * //   a: { b: 1, c: 2, f: 4 },
 * //   d: [1, 2, 3],
 * //   e: 'hello'
 * // }
 *
 * // Arrays are replaced, not merged
 * const parent2 = { arr: [1, 2] }
 * const child2 = {}
 * extendDeep(parent2, child2) // { arr: [] } (new empty array)
 *
 * // Nested objects are deeply copied
 * const parent3 = { user: { name: 'John', settings: { theme: 'dark' } } }
 * const child3 = {}
 * extendDeep(parent3, child3) // { user: { name: 'John', settings: { theme: 'dark' } } }
 * ```
 *
 * @since 1.0.0
 */
var extendDeep = function (parent, child) {
    if (child === void 0) { child = {}; }
    for (var i in parent) {
        if ((0, hasOwnProperty_1.default)(parent, i)) {
            if (typeof parent[i] === 'object') {
                child[i] = (0, isArray_1.default)(parent[i]) ? [] : {};
                extendDeep(parent[i], child[i]);
            }
            else {
                child[i] = parent[i];
            }
        }
    }
    return child;
};
exports.default = extendDeep;
//# sourceMappingURL=extendDeep.js.map