extend3.0.2 • Public • Published
node-extend is a port of the classic extend() method from jQuery. It behaves as you expect. It is simple, tried and true.
- Since Node.js >= 4,
Object.assignnow offers the same functionality natively (but without the "deep copy" option). See ECMAScript 2015 (ES6) in Node.js.
- Some native implementations of
Object.assignin both Node.js and many browsers (since NPM modules are for the browser too) may not be fully spec-compliant. Check
object.assignmodule for a compliant candidate.
This package is available on npm as:
npm install extend
Syntax: extend ( [
Extend one object with one or more others, returning the modified object.
var extend = ;;
Keep in mind that the target object will be modified, and will be returned from extend().
If a boolean true is specified as the first argument, extend performs a deep copy, recursively copying any objects it finds. Otherwise, the copy will share structure with the original object(s).
Undefined properties are not copied. However, properties inherited from the object's prototype will be copied over.
false as the first argument is not supported.
deepBoolean (optional) If set, the merge becomes recursive (i.e. deep copy).
targetObject The object to extend.
object1Object The object that will be merged into the first.
objectNObject (Optional) More objects to merge into the first.
node-extend is licensed under the MIT License.
All credit to the jQuery authors for perfecting this amazing utility.