Utility to perform a deep merge of a list of objects or arrays.
Last updated a month ago by thezimmee .
Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @brikcss/merge 
SYNC missed versions from official npm registry.

Deep Merge

NPM version NPM downloads per month Travis branch Codacy code quality grade Codacy code coverage Coverage Status JavaScript Style Guide code style: prettier semantic release Commitizen friendly Greenkeeper badge License

Utility to perform a deep merge of two or more Objects or Arrays.

Environment support

Node CLI UMD ES Module Browser


npm install @brikcss/merge --save-dev



const merge = require('@brikcss/merge');

JS Modules:

import merge from '@brikcss/merge';


const merge = window.brikcss.merge;


Pass list of objects (or arrays) directly to the merge function:


To use with options, set 1st argument as an Array of objects (or arrays) and set 2nd argument as options Object:

merge([...objects], options);


Merge works similarly to the Object.assign() method in that the first object is set as the merge target and will mutate with each merged object. If you wish to do a full clone, simply pass an empty Object (or Array) as the first object:

merge({}, obj1, obj2);
// Or with options:
merge([{}, obj1, obj2], options);


Merge(...objects) or Merge([...objects], options)

A container function to merge either Objects or Arrays. Any number of Objects or Arrays can be merged, but they all need to be either Objects or Arrays, not a mix of both.

If only two arguments exist, and the 1st argument is an Array and the 2nd is an Object, Merge will merge the items in the Array and treat the Object as options.

Merge.objects(target, source, options)

Returns the target Object, which is now merged with the source Object.

  • target {Object} Target to merge to.
  • source {Object} Object to merge with target.
  • options {Object} Configuration options.

Merge.arrays(target, source, options)

Returns the target Array, which is now merged with the source Array.

  • target {Array} Target to merge to.
  • source {Array} Array to merge with target.
  • options {Object} Configuration options.


arrayStrategy {String}

  • unique (default): Concatenate arrays and remove duplicates.
  • merge: Same as unique, except nested objects and arrays are merged.
  • concat: Concatenate arrays, but do not remove duplicates.
  • overwrite: Overwrite target array with source.

ignore {String[]}

Array of string paths to ignore, or not merge. Use object key names and/or array index values to specify values to ignore. For example: ignore: ['key', '1', 'a.b.c.d'] will ignore the object key key, the 2nd item an array, and the d property in the path a.b.c.d.

Current Tags

  • 1.3.0                                ...           dev (a month ago)
  • 1.3.0                                ...           latest (a month ago)

12 Versions

  • 1.3.0                                ...           a month ago
  • 1.2.1                                ...           6 months ago
  • 1.2.0                                ...           6 months ago
  • 1.1.0                                ...           10 months ago
  • 1.0.7                                ...           2 years ago
  • 1.0.6                                ...           2 years ago
  • 1.0.5                                ...           2 years ago
  • 1.0.4                                ...           2 years ago
  • 1.0.3                                ...           2 years ago
  • 1.0.2                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
Maintainers (1)
Today 0
This Week 1
This Month 14
Last Day 1
Last Week 12
Last Month 38
Dependencies (0)

Copyright 2014 - 2016 © taobao.org |