extend

Extends a value with another value using vanilla JavaScript. Similar in functionality to the jQuery extend function.

Notes:

• This function always performs a deep copy, there is no shallow copy option. Native solutions now exist for shallow copying.
• Arrays are not merged, they are replaced without referencing the original.
• Non-plain objects are passed by reference.
• undefined values are not merged into the target.

Installation

Using NPM:

npm install @alexspirgel/extend

const extend = require('@alexspirgel/extend');

Using a script tag:

Download the extend.js file from the /dist folder.

<script src="path/to/extend.js"></script>

Usage

Extend an object with other objects

extend(object1, object2, objects3);

object2 and object3 will be merged into object1.

Clone an object

let object2 = extend({}, object1);

object2 will be a clone of object1.

Example

const value1 = {
    a: 1,
    b: 2,
    c: {
        a: 1,
        b: 2
    },
    e: [
        true,
        'false'
    ]
};

const value2 = {
    b: '2',
    body: document.body, // passed by reference
    c: {
        b: 200,
        c: 3
    },
    d: 4,
    e: [
        false
    ]
};

const result = extend(value1, value2);

console.log(result);
/* 
Output:
{
    a: 1,
    b: '2',
    body: document.body,
    c: {
        a: 1,
        b: 200,
        c: 3
    }
    d: 4,
    e: [
        false
    ]
}
*/