kaskade

Merge objects deeply and sincerely, most definitely.

API

Kaskade gives you a single method to take care of all your object merging needs.

var kaskade = require("kaskade");

kaskade({a: 1}, {b: 2}, {c: 3});
// => {a: 1, b: 2, c: 3}

No Magic

Kaskade has no magic hidden behind the scenes. It treats each object as a key/value store. When objects are merged, if keys match, the last value will overwrite the previous value. If both values are objects, they will merge recursively. All values cascade to the first object passed.

No Defense

Kaskade does not try to defend itself from bad programmers. If you pass non-objects to Kaskade, expect it to blow up accordingly.

kaskade({}, 1);
// TypeError: Object.keys called on non-object

Example Uses

Bulk update an object

var a = {a: "a", b: "b", c: "c", d: "d"};

kaskade(a, {a: 1, b: 2});
// => {a: 1, b: 2, c: "c", d: "d"}

Override defaults

var defaults = {host: "localhost", port: 6379};

var options = kaskade({}, defaults, {user: "jsmith", port: 7000});
// => {host: "localhost", user: "jsmith", port: 7000}

Clone an object

var original = {a: 1},
    clone    = kaskade({}, original);

clone.a = 2; // 2
original.a;  // 1

Tests

Have piece of mind: Kaskade guarantees its sole feature with a handsome set of tests.

License

3-clause BSD

Author

smotchkkiss