Wondering what’s next for npm?Check out our public roadmap! »

    merge
    TypeScript icon, indicating that this package has built-in type declarations

    2.1.1 • Public • Published

    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
    

    Install

    npm i merge

    DownloadsWeekly Downloads

    2,093,730

    Version

    2.1.1

    License

    MIT

    Unpacked Size

    7 kB

    Total Files

    5

    Last publish

    Collaborators

    • avatar