lodash.clone

What is lodash.clone?

The lodash.clone package is a utility library that provides a method to create shallow copies of values. It is part of the larger Lodash library, which is known for its wide range of utility functions for common programming tasks.

What are lodash.clone's main functionalities?

Shallow Clone of Objects

This feature allows you to create a shallow copy of an object. The cloned object will have the same properties as the original object, but changes to the cloned object will not affect the original object.

const _ = require('lodash.clone');
const obj = { a: 1, b: 2 };
const clonedObj = _.clone(obj);
console.log(clonedObj); // { a: 1, b: 2 }

Shallow Clone of Arrays

This feature allows you to create a shallow copy of an array. The cloned array will have the same elements as the original array, but changes to the cloned array will not affect the original array.

const _ = require('lodash.clone');
const arr = [1, 2, 3];
const clonedArr = _.clone(arr);
console.log(clonedArr); // [1, 2, 3]

Shallow Clone of Nested Objects

This feature allows you to create a shallow copy of a nested object. Note that only the first level of the object is cloned; nested objects are still referenced.

const _ = require('lodash.clone');
const nestedObj = { a: { b: 2 } };
const clonedNestedObj = _.clone(nestedObj);
console.log(clonedNestedObj); // { a: { b: 2 } }
clonedNestedObj.a.b = 3;
console.log(nestedObj.a.b); // 3

Other packages similar to lodash.clone

clone

The 'clone' package provides both shallow and deep cloning capabilities. It is more versatile than lodash.clone as it can handle more complex data structures, including circular references.

rfdc

The 'rfdc' (Really Fast Deep Clone) package is optimized for performance and provides deep cloning capabilities. It is faster than lodash.clone for deep cloning operations but does not offer shallow cloning.

deepcopy

The 'deepcopy' package focuses on deep cloning and can handle complex data structures, including circular references. It is more specialized than lodash.clone, which only provides shallow cloning.

README

lodash.clone v3.0.2

The modern build of lodash’s _.clone exported as a Node.js/io.js module.

Installation

Using npm:

$ {sudo -H} npm i -g npm
$ npm i --save lodash.clone

In Node.js/io.js:

var clone = require('lodash.clone');

See the documentation or package source for more details.