Utility to perform a deep merge of a list of objects or arrays.
Last updated 4 months 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.
  • concat: Concatenate arrays, but do not remove duplicates.
  • overwrite: Overwrite target array with source.

Current Tags

  • 1.2.1                                ...           dev (4 months ago)
  • 1.2.1                                ...           latest (4 months ago)

11 Versions

  • 1.2.1                                ...           4 months ago
  • 1.2.0                                ...           4 months ago
  • 1.1.0                                ...           7 months ago
  • 1.0.7                                ...           a year ago
  • 1.0.6                                ...           a year ago
  • 1.0.5                                ...           a year ago
  • 1.0.4                                ...           a year ago
  • 1.0.3                                ...           a year ago
  • 1.0.2                                ...           a year ago
  • 1.0.1                                ...           a year ago
  • 1.0.0                                ...           a year ago
Maintainers (1)
Today 0
This Week 2
This Month 2
Last Day 2
Last Week 0
Last Month 0
Dependencies (0)

Copyright 2014 - 2016 © taobao.org |