242

What is the best way to clone an object in node.js

e.g. I want to avoid the situation where:

var obj1 = {x: 5, y:5};
var obj2 = obj1;
obj2.x = 6;
console.log(obj1.x); // logs 6

The object may well contain complex types as attributes, so a simple for(var x in obj1) wouldn't solve. Do I need to write a recursive clone myself or is there something built in that I'm not seeing?

4
  • 24
    1. npm install underscore 2. var _ = require('underscore') 3. _.clone(objToClone);
    – Salman
    Jul 24, 2012 at 18:50
  • 4
    Note that in in @SalmanPK's comment above, this is a shallow clone. so it will work for slifty's example, but if there are nested arrays or objects, they'll be references. :/
    – Jesse
    Aug 7, 2012 at 1:21
  • 1
    I found this article very helpful: heyjavascript.com/4-creative-ways-to-clone-objects Mar 17, 2013 at 15:15
  • 3
    @Jordan Hudson - Very nice use of JSON in the second example. var newObj = JSON.parse(JSON.stringify(oldObj)); //Now newObj is a clone. Only problem is that stringify will not work on recursive reference so need to be careful.
    – Kfir Erez
    Jul 18, 2013 at 15:42

22 Answers 22

334

Possibility 1

Low-frills deep copy:

var obj2 = JSON.parse(JSON.stringify(obj1));

Possibility 2 (deprecated)

Attention: This solution is now marked as deprecated in the documentation of Node.js:

The util._extend() method was never intended to be used outside of internal Node.js modules. The community found and used it anyway.

It is deprecated and should not be used in new code. JavaScript comes with very similar built-in functionality through Object.assign().

Original answer::

For a shallow copy, use Node's built-in util._extend() function.

var extend = require('util')._extend;

var obj1 = {x: 5, y:5};
var obj2 = extend({}, obj1);
obj2.x = 6;
console.log(obj1.x); // still logs 5

Source code of Node's _extend function is in here: https://github.com/joyent/node/blob/master/lib/util.js

exports._extend = function(origin, add) {
  // Don't do anything if add isn't an object
  if (!add || typeof add !== 'object') return origin;

  var keys = Object.keys(add);
  var i = keys.length;
  while (i--) {
    origin[keys[i]] = add[keys[i]];
  }
  return origin;
};
17
  • 5
    The question specifically called for a recursive clone. This is a shallow clone. Jul 15, 2013 at 21:13
  • 28
    Isn't a name like _* supposed to mean it's a private method and should not be relied upon?
    – Fluffy
    Jul 27, 2013 at 14:11
  • 7
    Every JavaScript project of any size has one or more implementations of extend(), and Node is no exception. The Node.js core makes extensive use of this function. To quote Isaacs, "It's not going anywhere any time soon."
    – jimbo
    Aug 2, 2013 at 21:15
  • 2
    worked perfectly for me. much better than messing about with Object prototype imo Sep 21, 2013 at 12:19
  • 13
    This is the WRONG answer. As per node's documentation: nodejs.org/api/util.html#util_util_extend_obj The util._extend() method was never intended to be used outside of internal Node.js modules. The community found and used it anyway. It is deprecated and should not be used in new code. JavaScript comes with very similar built-in functionality through Object.assign().
    – Jordie
    Jun 28, 2016 at 0:57
312

For a SHALLOW copy:

I'm surprised Object.assign hasn't been mentioned.

let cloned = Object.assign({}, source); // SHALLOW copy

If available (e.g. Babel), you can use the object spread operator:

let cloned = { ... source };
12
24
Object.defineProperty(Object.prototype, "extend", {
    enumerable: false,
    value: function(from) {
        var props = Object.getOwnPropertyNames(from);
        var dest = this;
        props.forEach(function(name) {
            if (name in dest) {
                var destination = Object.getOwnPropertyDescriptor(from, name);
                Object.defineProperty(dest, name, destination);
            }
        });
        return this;
    }
});

This will define an extend method that you can use. Code comes from this article.

5
  • I don't see how this is supposed to work. It modifies the original Object! How am I supposed to use this function to get a clone of an object? Can you add some usage code here? After reading your post and the blog post, I still can't figure out how this is intended to be used for cloning an object.
    – Brad
    Mar 28, 2012 at 3:30
  • 3
    does this really work? "if (name in dest)" - will only change the property if it already exists in dest. it should be negated.
    – memical
    Mar 30, 2012 at 14:14
  • 8
    Isn't modifying Object.prototype supposed to be verboten? Also that article link is broken. Oct 9, 2012 at 4:08
  • Just tried the article link and it works for me. Maybe it was a network blip when you tried it. Oct 9, 2012 at 15:14
  • Based on a number of comments, I've updated the answer to include a variant that does not add to object's prototype. Jul 31, 2014 at 11:14
20
var obj2 = JSON.parse(JSON.stringify(obj1));
4
  • 8
    This was already suggested in this existing answer no point repeating it. Jun 24, 2013 at 12:15
  • 1
    @ShadowWizard these are different methods. This one simply converts to json and back to object, while linked answer uses Object.keys() to iterate through object
    – mente
    Oct 16, 2013 at 11:21
  • 2
    This answer is wrong. JSON.stringify takes a date object and reduces it to a string, and then after parsing it leaves it as a string so it mutates the state of your object leaving you with a different object than initially in case of dates.
    – twboc
    Jan 17, 2020 at 8:10
  • 1
    Further to @twboc, object properties that are explicitly undefined will not be copied using this method.
    – storsoc
    Apr 19, 2022 at 17:49
13

You can use the extend function from JQuery:

var newClone= jQuery.extend({}, oldObject);  
var deepClone = jQuery.extend(true, {}, oldObject); 

There is a Node.js Plugin too:

https://github.com/shimondoodkin/nodejs-clone-extend

To do it without JQuery or Plugin read this here:

http://my.opera.com/GreyWyvern/blog/show.dml/1725165

1
  • To post a jQuery solution for NODE is rather dumb! At least you could have extracted the code and offer a node solution in here, but too lazy!
    – DATEx2
    Feb 9 at 7:17
12

Check out underscore.js. It has both clone and extend and many other very useful functions.

This can be useful: Using the Underscore module with Node.js

9

There are some Node modules out there if don't want to "roll your own". This one looks good: https://www.npmjs.com/package/clone

Looks like it handles all kinds of stuff, including circular references. From the github page:

clone masters cloning objects, arrays, Date objects, and RegEx objects. Everything is cloned recursively, so that you can clone dates in arrays in objects, for example. [...] Circular references? Yep!

0
7

This code is also work cause The Object.create() method creates a new object with the specified prototype object and properties.

var obj1 = {x:5, y:5};

var obj2 = Object.create(obj1);

obj2.x; //5
obj2.x = 6;
obj2.x; //6

obj1.x; //5
2
  • 7
    this is a shallow copy Mar 3, 2016 at 16:13
  • Additionally, while this works fine with an object created via an object literal, it doesn't when cloning something like process.env: While direct property access on the clone works, reflecting on it doesn't; e.g. let clone = Object.create(process.env); JSON.stringify(clone); Reflect.ownKeys(c) yields '{}' and []
    – mklement0
    Jan 11 at 16:31
7

There is another library lodash, it has clone and cloneDeep.

clone will clone your object but not create a new instance for non-primitive values, instead it will use the referrence to the original object

cloneDeep will create literally new objects without having any referrence to the original object, so it more safe when you have to change the object afterwards.

5

Simple and the fastest way to clone an Object in NodeJS is to use Object.keys( obj ) method

var a = {"a": "a11", "b": "avc"};
var b;

for(var keys = Object.keys(a), l = keys.length; l; --l)
{
   b[ keys[l-1] ] = a[ keys[l-1] ];
}
b.a = 0;

console.log("a: " + JSON.stringify(a)); // LOG: a: {"a":"a11","b":"avc"} 
console.log("b: " + JSON.stringify(b)); // LOG: b: {"a":0,"b":"avc"}

The method Object.keys requires JavaScript 1.8.5; nodeJS v0.4.11 supports this method

but of course for nested objects need to implement recursive func


Other solution is to use native JSON (Implemented in JavaScript 1.7), but it's much slower (~10 times slower) than previous one

var a = {"a": i, "b": i*i};
var b = JSON.parse(JSON.stringify(a));
b.a = 0;
5

There is also a project on Github that aims to be a more direct port of the jQuery.extend():

https://github.com/dreamerslab/node.extend

An example, modified from the jQuery docs:

var extend = require('node.extend');

var object1 = {
    apple: 0,
    banana: {
        weight: 52,
        price: 100
    },
    cherry: 97
};

var object2 = {
    banana: {
        price: 200
    },
    durian: 100
};

var merged = extend(object1, object2);
5

All modern browsers and Node V17+ support the global structuredClone() function:

const obj2 = structuredClone(obj1);
1
  • Looks like a modern solution.
    – HyoJin KIM
    Dec 18, 2023 at 8:06
4

Looking for a true clone option, I stumbled across ridcully's link to here:

http://my.opera.com/GreyWyvern/blog/show.dml/1725165

I modified the solution on that page so that the function attached to the Object prototype is not enumerable. Here is my result:

Object.defineProperty(Object.prototype, 'clone', {
    enumerable: false,
    value: function() {
        var newObj = (this instanceof Array) ? [] : {};
        for (i in this) {
        if (i == 'clone') continue;
            if (this[i] && typeof this[i] == "object") {
                newObj[i] = this[i].clone();
            } else newObj[i] = this[i]
        } return newObj;
    }
});

Hopefully this helps someone else as well. Note that there are some caveats... particularly with properties named "clone". This works well for me. I don't take any credit for writing it. Again, I only changed how it was being defined.

1
  • This is wrong. Dates type is object so this code would replace dates by empty objects... Don't use this.
    – WispyCloud
    Dec 23, 2013 at 23:03
1

You can also use SugarJS in NodeJS.

http://sugarjs.com/

They have a very clean clone feature: http://sugarjs.com/api/Object/clone

0

None of the answers satisfied me, several don't work or are just shallow clones, answers from @clint-harris and using JSON.parse/stringify are good but quite slow. I found a module that does deep cloning fast: https://github.com/AlexeyKupershtokh/node-v8-clone

0

There is no built-in way to do a real clone (deep copy) of an object in node.js. There are some tricky edge cases so you should definitely use a library for this. I wrote such a function for my simpleoo library. You can use the deepCopy function without using anything else from the library (which is quite small) if you don't need it. This function supports cloning multiple data types, including arrays, dates, and regular expressions, it supports recursive references, and it also works with objects whose constructor functions have required parameters.

Here is the code:

//If Object.create isn't already defined, we just do the simple shim, without the second argument,
//since that's all we need here
var object_create = Object.create;
if (typeof object_create !== 'function') {
    object_create = function(o) {
        function F() {}
        F.prototype = o;
        return new F();
    };
}

/**
 * Deep copy an object (make copies of all its object properties, sub-properties, etc.)
 * An improved version of http://keithdevens.com/weblog/archive/2007/Jun/07/javascript.clone
 * that doesn't break if the constructor has required parameters
 * 
 * It also borrows some code from http://stackoverflow.com/a/11621004/560114
 */ 
function deepCopy = function deepCopy(src, /* INTERNAL */ _visited) {
    if(src == null || typeof(src) !== 'object'){
        return src;
    }

    // Initialize the visited objects array if needed
    // This is used to detect cyclic references
    if (_visited == undefined){
        _visited = [];
    }
    // Ensure src has not already been visited
    else {
        var i, len = _visited.length;
        for (i = 0; i < len; i++) {
            // If src was already visited, don't try to copy it, just return the reference
            if (src === _visited[i]) {
                return src;
            }
        }
    }

    // Add this object to the visited array
    _visited.push(src);

    //Honor native/custom clone methods
    if(typeof src.clone == 'function'){
        return src.clone(true);
    }

    //Special cases:
    //Array
    if (Object.prototype.toString.call(src) == '[object Array]') {
        //[].slice(0) would soft clone
        ret = src.slice();
        var i = ret.length;
        while (i--){
            ret[i] = deepCopy(ret[i], _visited);
        }
        return ret;
    }
    //Date
    if (src instanceof Date) {
        return new Date(src.getTime());
    }
    //RegExp
    if (src instanceof RegExp) {
        return new RegExp(src);
    }
    //DOM Element
    if (src.nodeType && typeof src.cloneNode == 'function') {
        return src.cloneNode(true);
    }

    //If we've reached here, we have a regular object, array, or function

    //make sure the returned object has the same prototype as the original
    var proto = (Object.getPrototypeOf ? Object.getPrototypeOf(src): src.__proto__);
    if (!proto) {
        proto = src.constructor.prototype; //this line would probably only be reached by very old browsers 
    }
    var ret = object_create(proto);

    for(var key in src){
        //Note: this does NOT preserve ES5 property attributes like 'writable', 'enumerable', etc.
        //For an example of how this could be modified to do so, see the singleMixin() function
        ret[key] = deepCopy(src[key], _visited);
    }
    return ret;
};
0

You can also use this clone library to deep clone objects.

 npm install --save clone
const clone = require('clone');

const clonedObject = clone(sourceObject);

0

If you're working with ordinary objects and arrays, and don't care about cloning functions or recursive references, here's a simple deepClone implementation which works on ordinary objects, arrays, strings, numbers, regex, dates, etc.

// Simple Deep Clone
// Does not clone functions or handle recursive references.
function deepClone(original) {
  if (original instanceof RegExp) {
    return new RegExp(original);
  } else if (original instanceof Date) {
    return new Date(original.getTime());
  } else if (Array.isArray(original)) {
    return original.map(deepClone);
  } else if (typeof original === 'object' && original !== null) {
    const clone = {};
    Object.keys(original).forEach(k => {
      clone[k] = deepClone(original[k]);
    });
    return clone;
  }
  return original;
}

// Usage:

const obj = { n: 1, a: [ { a: 1 }, { a: 2 } ], d: new Date(), s: 'foo' };
const clone = deepClone(obj);
0

Good article about this problem: https://www.samanthaming.com/tidbits/70-3-ways-to-clone-objects/

var obj1 = {x: 5, y:5};
var obj2 = Object.assign({}, obj1 );
    
obj2  = {z: 10};
    
console.log(obj1);
console.log(obj2);
-1

Another solution is to encapsulate directly in the new variable using: obj1= {...obj2}

1
-2

If you're using coffee-script, it's as easy as:

newObject = {}
newObject[key] = value  for own key,value of oldObject

Though this isn't a deep clone.

2
  • ...but the OP isn't using CoffeeScript... how is this relevant?!
    – Adam
    Apr 28, 2022 at 20:48
  • this is just a LAME answer - totally useless. The question was about pure NODE not crappy script
    – DATEx2
    Feb 9 at 7:23
-2

You can prototype object and then call object instance every time you want to use and change object:

function object () {
  this.x = 5;
  this.y = 5;
}
var obj1 = new object();
var obj2 = new object();
obj2.x = 6;
console.log(obj1.x); //logs 5

You can also pass arguments to object constructor

function object (x, y) {
   this.x = x;
   this.y = y;
}
var obj1 = new object(5, 5);
var obj2 = new object(6, 6);
console.log(obj1.x); //logs 5
console.log(obj2.x); //logs 6

Hope this is helpful.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.