Dcp NPM | npm.io

dcp

This module supports making copy / clone deeply and faster.

Benchmark

Node.js: v12.7.0
benchmark.js: v2.1.0

yarn benchmark

[1] "dcp" 0.0665μs[1.00][1.00]
[2] "JSON" 3.73μs[0.0178][56.1]
[3] "lodash" 3.76μs[0.0177][56.6]

Usage

Runtime parsing

If the reference of the base object is NOT changed, you can use it without defining a key.

const obj = {
  a: 10,
  c: [1, 2],
  d: {}
};

// only first time, it will be parsed
const newObj = dcp.clone(obj);
/*
 * { a: 10,
 *   b: '',
 *   c: [1, 2],
 *   d: { d1: false } }
 */

Runtime parsing with a key

If the reference is changed but the format is the same, you need to use it with a key.

// only first time, it will be parsed
const newObj = dcp.clone('key1', obj);
/*
 * { a: 10,
 *   b: '',
 *   c: [1, 2],
 *   d: { d1: false } }
 */

// get the default values
const newObj2 = dcp.clone('key1');
/*
 * { a: 0,
 *   b: '',
 *   c: [0, 0],
 *   d: { d1: false } }
 */

Pre-defined

It is the fastest way, but the difference is only the first clone.

const structure = {
  a: 1,
  b: 'default',
  c: [undefined, undefined],
  d: { d1: true }
};
const key = 'test';
dcp.define(key, structure);
const newObj = dcp.clone(key, obj);