defaults-shallow

Extend an object with the properties of other objects, but only if they don't already exist.

How is this different than extend or assign?

[extend][] and assign: "last one wins" - properties are updated or overwritten by new values.
defaults: "first one wins" - only new properties are filled in.

Install

Install with npm

$ npm i defaults-shallow --save

var defaults = require('defaults-shallow');

defaults({a: 'b'}, {c: 'd'});
//=> {a: 'b', c: 'd'}

defaults({a: 'b'}, {a: 'c'});
//=> {a: 'b'}

To shallow clone you can use an empty object as the first argument:

var options = defaults({}, {a: 'b'}, {c: 'd'}, {a: 'f'});
//=> {a: 'b', c: 'd'}

defaults-deep: Like extend but recursively copies only the missing properties/values to the target object. | homepage
extend-shallow: Extend an object with the properties of additional objects. node.js/javascript util. | homepage
merge-deep: Recursively merge values in a javascript object. | homepage
mixin-deep: Deeply mix the properties of objects into the first object. Like merge-deep, but doesn't clone. | homepage

Install dev dependencies:

$ npm i -d && npm test

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Jon Schlinkert

This file was generated by verb-cli on October 04, 2015.