Package Exports
- fast-clone
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (fast-clone) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
The fastest deep cloning function on NPM that supports the following types:
- Objects (POJOs, null, undefined)
- Arrays
- Dates
- Regular Expressions
- Strings
- Numbers (NaN, Positive Infinity, Negative Infinity)
- Booleans
Speed Comparison
Average runtime of various NPM clone libraries on a large complex object loaded from json files of varying sizes ranging from 3.5 MB to 15 MB.
| Library | 7.15 MB |
|---|---|
| ✔ fast-clone | 120 ms |
| ✘ deepClone | 138 ms |
| ✘ lodash.cloneDeep | 155 ms |
| ✘ snapshot | 1,127 ms |
| ✘ angular.copy | 1,942 ms |
| ✘ clone | 2,085 ms |
Installation
NPM
npm install fast-clone --saveYarn
yarn add fast-cloneUsage
Fast-clone is a UMD module so you can use it in Node.js, or in Browser either using Browserfy/Webpack, or by using the global clone function if not using a module loader.
TypeScript
import clone = require('fast-clone');JavaScript
const clone = require('fast-clone');const a = {
name: 'Natasha Rominov',
age: 30,
skills: [
'Pistols',
'Espionage'
],
dateOfBirth: new Date('1986-05-21T00:00:00.000Z')
};
const b = clone(a);
b.skills.push('That grabby thing she does with her legs');
console.log(a.skills)
console.log(b.skills);Output will be:
['Pistols', 'Espionage']
['Pistols', 'Espionage', 'That grabby thing she does with her legs']Contributing
Got an issue or a feature request? Log it.
Pull-requests are also welcome. 😸