2.0.2 • Published 10 years ago

plain-merge v2.0.2

Weekly downloads
9
License
MIT
Repository
github
Last release
10 years ago

Plain Merge

Yet another utility for merging JavaScript objects.

Install

Install using NPM. This package is compatible in the browser using Browserify.

$ npm install plain-merge
var merge = require("plain-merge");
merge.extend({ a: true }, { foo: "bar" });

Usage

merge()

merge( a, b [, safe ] ) // → a

Merges some value b into a. When both values are plain objects, this method recursively merges b's own enumerable properties onto a and returns a. Otherwise, the safe argument is used to determine which value is returned where true is a and false is b.

This is the base merge method and you probably won't need to use this directly. Listed below are the practical implementations of this method.

merge.extend()

merge.extend(val [, mixin... ] ) // → val

Merges each mixin argument into val, where non-object mixin values will replace val (i.e. safe is set to false). This is basically the deep equivalent of _.extend().

merge.defaults()

merge.defaults(val [, mixin... ] ) // → val

Merges each mixin argument into val, where non-object mixin values are ignored (i.e. safe is set to true). This is basically the deep equivalent of _.defaults().