extend-fn v0.0.6

Grunt Mocha Test Coverage

extend() objects for Node.js

extend-fn is self written method to extend json objects recursively.

These objects can also have functions as properties.

The implementation of this extend method is due to a personal use in a project i am working on. All other extend modules found in npm could not extend an object with other that has functions as properties.

Installation

This package is availabe on npm as: extend-fn

npm install extend-fn

Usage

Syntax: extend ( to_extend, object1, objectN )

Extend one object with one or more other objects, returning the result object.

Example:

var extend = require('extend-fn');
var result = extend(to_be_extended, obj1, obj2, objX);

Keep in mind that the final result is the object, that will be returned from extend().

Arguments

• to_extend Object The object to extend.
• object1 Object The object that will be merged into the first.
• objectN Object (Optional) More objects to merge into the first.

Example

var extend = require('extend-fn');

var to = {
    property_x: function () {
        return true;
    }
};

var obj1 = {
    property_x: function() {
        return false;
    },
    property_y: {
        i: function() {
            return true;
        }
    }
};

var obj2 = {
    property_x: function() {
        return "hello world";
    },
    property_z: 1
};

var obj3 = {
    property_x: function() {
        return "i am final";
    },
    property_z: 2,
    property_y: {
        i: function() {
            return false;
        },
        j: 23
    },
    property_w: 'i am a word'
};

var expected = {
    property_x: function() {
        return "i am final";
    },
    property_y: {
        i: function() {
            return false;
        },
        j: 23
    },
    property_z: 2,
    property_w: 'i am a word'
};

var result = extend(to, obj1, obj2, obj3);

// result is deep equal to expected

License

extend-fn is licensed under the MIT License.