extend
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/extend package

    3.0.2 • Public • Published

    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.

    Notes:

    • Since Node.js >= 4, Object.assign now offers the same functionality natively (but without the "deep copy" option). See ECMAScript 2015 (ES6) in Node.js.
    • Some native implementations of Object.assign in both Node.js and many browsers (since NPM modules are for the browser too) may not be fully spec-compliant. Check object.assign module for a compliant candidate.

    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.

    Example:

    var extend = require('extend');
    extend(targetObject, object1, object2);

    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.

    Install

    npm i extend

    DownloadsWeekly Downloads

    23,408,647

    Version

    3.0.2

    License

    MIT

    Unpacked Size

    23.5 kB

    Total Files

    10

    Last publish

    Collaborators

    • justmoon
    • ljharb