normalize-defaults

Normalize missing first-level keys/values in an object with those from defaults.

Examples

• Example 1

var normalize = require('normalize-defaults');
 
var obj = { 
    rhinos: null, 
    wolves: 15,
    tigers: 42
};
 
var defaults = { 
    rhinos: 8,
    lions: 0,
    wolves: 14
};
 
obj = normalize(obj, defaults);
 
console.log(obj); 
// { rhinos: 8, wolves: 15, tigers: 42, lions: 0 }

• Example 2

var normalize = require('normalize-defaults');
 
var obj = {};
var defaults = {
    arr: []
};
 
obj = normalize(obj, defaults);
 
obj.arr.push(5);
 
console.log(obj.arr); // [5]
console.log(defaults.arr); // [] - defaults' objects remains unaffected

• Example 3

var normalize = require('normalize-defaults');
 
var obj = null;
var defaults = {
    a: 42
};
 
obj = normalize(obj, defaults);
 
console.log(obj.a); // 42

Changelog

v0.1.4

• If the object to normalize is null, use the default object entirely
• The previous change now requires that the return value be used, since the null first argument cannot be modified.

License

MIT