add-or-extend v1.0.0

Description

• Just adds or extends an object depending on whenther the key exists

Usage

npm install add-or-extend --save
var addOrExtend = require('add-or-extend');

var targetObject = {
  theKey: [
    'hello', 
    'world'
  ]
};

var key = 'theKey';
var sourceObject = {
  any: 'thing'
}
// requires all params or will throw an error
var after = addOrExtend(targetObject, key, sourceObject)
console.log(after);
// { theKey: [ 'hello', 'world', { any: 'thing' } ] }

var key = 'anotherKey';
var sourceObject = {
    any: 'thing'
}
var after = addOrExtend(targetObject, key, sourceObject);
console.log(after);
//  { theKey: [ 'hello', 'world', { any: 'thing' } ], anotherKey: { any: 'thing' } }

var targetObject = {
  theKey: {
    hello: 'world'
  }
};
var sourceObject = {
    any: 'thing'
}
var key = 'theKey';
var after = addOrExtend(targetObject, key, sourceObject);
console.log(after);
//{ theKey: { hello: 'world', any: 'thing' } }

if multipleSourceobjects == true and sourceObject is an array of length 2, sourceObject0 will be used when the key exists in the targetObject and sourceObject1 will be used if key does not exist in targetObject

var targetObject = {
  theKey: {
    hello: 'world'
  }
};
var sourceObject = [
  { keyExists: 'addThis'},
  {keyDoesNot: { add: 'that'}}
]
var after = addOrExtend(targetObject, 'theKey', sourceObject, true);
console.log(after);
//{ theKey: { hello: 'world', keyExists: 'addThis' } }
var after = addOrExtend(targetObject, 'notTheKey', sourceObject, true);
console.log(after);
//{ theKey: { hello: 'world' }, notTheKey: { keyDoesNot: { add: 'that' } } }