Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Simple function to extend objects
Pull request Compare This branch is 139 commits behind justmoon:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

extend() for Node.js

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


This package is available on NPM as: extend

npm install extend


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.


  • 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.


node-extend is licensed under the MIT License.


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

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

Something went wrong with that request. Please try again.