https://github.com/igorskyflyer/npm-clone-js

🧬 A NPM wrapper around a lightweight JavaScript utility allowing deep copy-by-value of nested objects, arrays and arrays of objects. 🪁
https://github.com/igorskyflyer/npm-clone-js

array back-end biome clone clonejs igorskyflyer javascript js nested-objects node nodejs npm object package typescript vitest wrapper

Last synced: 4 months ago
JSON representation

🧬 A NPM wrapper around a lightweight JavaScript utility allowing deep copy-by-value of nested objects, arrays and arrays of objects. 🪁

• Host: GitHub
• URL: https://github.com/igorskyflyer/npm-clone-js
• Owner: igorskyflyer
• License: mit
• Created: 2019-10-16T00:38:47.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2025-08-27T23:38:11.000Z (10 months ago)
• Last Synced: 2025-10-30T23:19:33.860Z (7 months ago)
• Topics: array, back-end, biome, clone, clonejs, igorskyflyer, javascript, js, nested-objects, node, nodejs, npm, object, package, typescript, vitest, wrapper
• Language: TypeScript
• Homepage: https://www.npmjs.com/package/@igorskyflyer/clone
• Size: 606 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Support: SUPPORT.md

Awesome Lists containing this project

README

          


  

  
clone.js








  🧬 A lightweight JavaScript utility allowing deep copy-by-value of nested objects, arrays and arrays of objects. 🪁









## 📃 Table of Contents

- [Features](#-features)

- [Usage](#-usage)

- [API](#-api)

- [Changelog](#-changelog)

- [Support](#-support)

- [License](#-license)

- [Related](#-related)

- [Author](#-author)







## 🤖 Features

- 🧬 Deep‑clones objects and arrays with full fidelity

- 🔁 Recursively copies nested structures without mutation

- 🛡️ Preserves original data while enabling safe edits

- 🧠 Smart handling of null and non‑object values

- 🧩 Works with mixed arrays, primitives, and objects

- ⚙️ Zero dependencies - drop‑in and lightweight

- 🚀 Ideal for state snapshots, undo systems, or sandboxing







## 🕵🏼 Usage

Install it by executing any of the following, depending on your preferred package manager:

```bash

pnpm add @igorskyflyer/clone

```

```bash

yarn add @igorskyflyer/clone

```

```bash

npm i @igorskyflyer/clone

```







## 🤹🏼 API

### Simple array copy

```javascript

import { clone } from '@igorskyflyer/clone'

const firstArray = [1, 2, 3]

const secondArray = clone(firstArray)

secondArray[0] = 5

console.log('firstArray => ', firstArray) // [1, 2, 3]

console.log('secondArray => ', secondArray) // [5, 2, 3]

```

### Complex array (array of objects)

```javascript

import { clone } from '@igorskyflyer/clone'

const firstArray = [

  {

    id: '103',

    name: 'Peter',

  },

  {

    id: '214',

    name: 'Eve',

  },

]

const secondArray = clone(firstArray)

secondArray[0].name = 'John'

console.log('firstArray => ', firstArray)

console.log('secondArray => ', secondArray)

```

### Simple object copy

```javascript

import { clone } from '@igorskyflyer/clone'

const firstStudent = {

  id: 103,

  name: 'Ben',

  classes: ['Maths', 'Science', 'English language'],

}

const secondStudent = clone(firstStudent)

secondStudent.classes[0] = 'Psychology'

console.log('firstStudent => ', firstStudent)

console.log('secondStudent => ', secondStudent)

```

### Nested object copy

```javascript

import { clone } from '@igorskyflyer/clone'

const firstStudent = {

  id: 103,

  name: 'Ben',

  subjects: {

    groupDke: {

      science: 'B',

      maths: 'C',

    },

    groupOpe: {

      foo: 'bar',

    },

  },

}

const secondStudent = clone(firstStudent)

secondStudent.subjects.groupDke.maths = 'B'

console.log('firstStudent => ', firstStudent)

console.log('secondStudent => ', secondStudent)

```







## 📝 Changelog

📑 The changelog is available here, [CHANGELOG.md](https://github.com/igorskyflyer/npm-clone-js/blob/main/CHANGELOG.md).







## 🪪 License

Licensed under the MIT license which is available here, [MIT license](https://github.com/igorskyflyer/npm-clone-js/blob/main/LICENSE).







## 💖 Support



  I work hard for every project, including this one and your support means a lot to me!

  


  Consider buying me a coffee. ☕

  


  


  

  


  


  Thank you for supporting my efforts! 🙏😊









## 🧬 Related

[@igorskyflyer/pathexists](https://www.npmjs.com/package/@igorskyflyer/pathexists)

> _🧲 Provides ways of properly checking if a path exists inside a given array of files/directories both on Windows and UNIX-like operating systems. 🗺_

[@igorskyflyer/zep](https://www.npmjs.com/package/@igorskyflyer/zep)

> _🧠 Zep is a zero-dependency, efficient debounce module. ⏰_

[@igorskyflyer/valid-path](https://www.npmjs.com/package/@igorskyflyer/valid-path)

> _🧰 Provides ways of testing whether a given value can be a valid file/directory name. 🏜_

[@igorskyflyer/my-file-path](https://www.npmjs.com/package/@igorskyflyer/my-file-path)

> _🌟 An npm module that strongly types file paths! 🥊_

[@igorskyflyer/recursive-readdir](https://www.npmjs.com/package/@igorskyflyer/recursive-readdir)

> _📖 Provides recursive readdir() and readdirSync() functions. 📁_










## 👨🏻‍💻 Author

Created by **Igor Dimitrijević** ([*@igorskyflyer*](https://github.com/igorskyflyer/)).