The clone npm package is a utility for cloning JavaScript objects. It can create deep copies of objects, arrays, dates, and other types, ensuring that changes to the cloned object do not affect the original. It is useful when you need to work with copies of data without altering the original source.

What are clone's main functionalities?

Cloning objects

This feature allows you to create a deep copy of an object, so that changes to the cloned object do not affect the original object.

{"const clone = require('clone');
const obj = { a: 1, b: { c: 2 } };
const objClone = clone(obj);
console.log(objClone); // { a: 1, b: { c: 2 } }
objClone.b.c = 3;
console.log(obj.b.c); // 2, original object is not affected"}

Cloning arrays

This feature allows you to create a deep copy of an array, including any nested arrays, without affecting the original array.

{"const clone = require('clone');
const arr = [1, 2, [3, 4]];
const arrClone = clone(arr);
console.log(arrClone); // [1, 2, [3, 4]]
arrClone[2][0] = 5;
console.log(arr[2][0]); // 3, original array is not affected"}

Cloning dates

This feature allows you to clone Date objects, creating a new instance that represents the same moment in time as the original.

{"const clone = require('clone');
const date = new Date();
const dateClone = clone(date);
console.log(dateClone); // date object representing the same moment in time
console.log(date === dateClone); // false, they are different instances"}

Other packages similar to clone

Readme

Source

clone offers foolproof deep cloning of variables in JavaScript.

Example

var clone = require('clone');

var a, b;
a = { foo: { bar: 'baz' } };
b = clone(a);
a.foo.bar = 'foo';

console.log(b);

This will print:

{ foo: { bar: 'baz' } }

It masters cloning objects, arrays, functions, dates (not save; objects that define a property getTime, which must be a function). There is no error if undefined is given.

Everything is cloned recursively, so that you can clone dates in arrays in objects… for example.

FAQs

What is clone?

Is clone popular?

Is clone well maintained?

Last updated on 06 Oct 2011

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install