merge

(recursive)? merging of (cloned)? objects.

Usage no npm install needed!

<script type="module">
  import merge from 'https://cdn.skypack.dev/merge';
</script>

README

Merge

(recursive)? merging of (cloned)? objects.

Install

Node.js

npm i merge
import merge from 'merge'

Browser

<script src="https://cdn.jsdelivr.net/gh/yeikos/js.merge/dist/merge.browser.min.js"></script>
window.merge

API

merge(clone: boolean, ...items: Object[])
merge(...items: Object[])
merge.recursive(clone: boolean, ...items: Object[])
merge.recursive(...items: Object[])

Examples


// Merge 

{
    var objectA = {} 

    merge(objectA, 
        { value: 1 }, 
        { str: 'hello world' }
    )

    var objectB = merge(true, objectA, 
        { value: 2 }
    )

    objectA // { value: 1, str: 'hello world' }
    objectB // { value: 2, str: 'hello world' }
}

// Recursive merge

{
    var objectA = {}

    merge.recursive(objectA, 
        { level: { value: 1 } },
        { level: { str: 'hello world' } }
    )
    var objectB = merge.recursive(true, objectA, 
        { level: { value: 2 } }
    )

    objectA.level // { value: 1, str: 'hello world' }
    objectB.level // { value: 2, str: 'hello world' }
}

Test

Node.js

npm test

Browser

./dist/merge.browser.test.html