a123456789 bff0ff0e1f products 2 years ago
..
.eslintrc bff0ff0e1f products 2 years ago
.jscs.json bff0ff0e1f products 2 years ago
.npmignore bff0ff0e1f products 2 years ago
.travis.yml bff0ff0e1f products 2 years ago
CHANGELOG.md bff0ff0e1f products 2 years ago
LICENSE bff0ff0e1f products 2 years ago
README.md bff0ff0e1f products 2 years ago
component.json bff0ff0e1f products 2 years ago
index.js bff0ff0e1f products 2 years ago
package.json bff0ff0e1f products 2 years ago

README.md

Build Status dependency status dev dependency status

extend() for Node.js Version Badge

node-extend is a port of the classic extend() method from jQuery. It behaves as you expect. It is simple, tried and true.

Installation

This package is available on npm as: extend

npm install extend

Usage

Syntax: extend ( [deep], target, object1, [objectN] )

Extend one object with one or more others, returning the modified object.

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. Warning: passing false as the first argument is not supported.

Arguments

  • deep Boolean (optional) If set, the merge becomes recursive (i.e. deep copy).
  • target 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.

License

node-extend is licensed under the MIT License.

Acknowledgements

All credit to the jQuery authors for perfecting this amazing utility.

Ported to Node.js by Stefan Thomas with contributions by Jonathan Buchanan and Jordan Harband.