@gby/deep-copy

deep-copy 深拷贝，可对任意数据进行深度拷贝，包括 函数 function、正则 RegExp、Map、Set、Date、Array、URL 等等；支持含循环引用对象的拷贝，并且不会丢失成员的引用关系 和 类型信息，支持扩展，可根据数据类型定制拷贝逻辑，也可指定拷贝深度；所以，通过它可实现对任意类型的数据进行任意想要的拷贝

Usage no npm install needed!

<script type="module">
  import gbyDeepCopy from 'https://cdn.skypack.dev/@gby/deep-copy';
</script>

README

目录

内容

1. 背景

开发中，经常需要对一个对象进行深拷贝操作，目前经常用到的深拷贝的方式有以下几种：

  • 将对象序列化成 JSON 字符串后，再反序化成对象 let copy = JSON.parse(JSON.stringify(value))
  • 第三方库提供的深拷贝工具，如 Lodash 的 _.cloneDeep(value) 和 _.cloneDeepWith(value, customizer)

但这些方法有以下缺点：

  • 不支持对象成员循环引用，比如下面这种： 循环引用
  • 拷贝后会丢失类型信息，变成了普通的对象
  • 拷贝后会丢失成员引用关系信息
  • 不能根据类型自定义拷贝规则
  • 只能拷贝可枚举的属性
  • 不能拷贝函数
  • 不能指定拷贝深度

为了解决这些问题，deep-copy 就出现了👏

2. 简介

deep-copy 是一个深拷贝工具，可对任意数据进行深度拷贝，包括 函数 function、正则 RegExp、Map、Set、Date、Array、URL 等等；支持含循环引用关系的对象的拷贝，并且不会丢失成员的引用关系信息 和 类型信息，支持扩展，可根据数据类型定制拷贝逻辑，也可指定拷贝深度；所以，通过它可实现对任意类型的数据进行任意想要的拷贝；

具有以下特性：

  • 支持对象成员循环引用
  • 拷贝后不会丢失类型信息 和 成员引用关系信息
  • 可指定拷贝深度
  • 即能拷贝可枚举的成员，也可拷贝不可枚举的成员
  • 可拷贝函数
  • 可根据类型自定义拷贝规则
  • 支持预设拷贝规则
  • 支持创建多个不同预设拷贝规则的拷贝函数

详情请看：

如果您在使用的过程中遇到了问题，或者有好的建议和想法，您都可以通过以下方式联系我，期待与您的交流：

  • 给该仓库提交 issues
  • 给我 Pull requests
  • 邮箱：guobinyong@qq.com
  • QQ：guobinyong@qq.com
  • 微信：keyanzhe

3. 安装方式

目前，安装方式有以下几种：

3.1. 方式1：通过 npm 安装

npm install @gby/deep-copy

3.2. 方式2：直接下载原代码

您可直接从项目的 发行地址 下载 源码 或 构建后包文件；

您可以直接把 源码 或 构建后 的包拷贝到您的项目中去；然后使用如下代码在您的项目中引入 deepCopy：

import { deepCopy } from "path/to/package/deep-copy";

或者

import deepCopy from "path/to/package/deep-copy";

3.3. 方式3：通过<script>标签引入

您可直接从项目的 发行地址 中下载以 .iife.js 作为缀的文件，然后使用如下代码引用 和 使用 deep-copy：

  1. 引用 deep-copy

    <script src="path/to/package/deep-copy.iife.js"></script>

  2. 使用全局的 deepCopy

    <script>
// 使用全局的 deepCopy
    const copy = deepCopy.deepCopy(value);
</script>

4. 教程

详情跳转至教程

5. API接口文档

详情跳转至API接口文档

有您的支持，我会在开源的道路上，越走越远

赞赏码