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: 6 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 (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2024-06-22T16:13:36.000Z (over 1 year ago)
• Last Synced: 2025-03-12T21:49:41.225Z (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/@igor.dvlpr/node-clone-js
• Size: 526 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
![clone.js](https://github.com/igorskyflyer/npm-clone-js/raw/main/assets/clone.js.png)

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

# npm('clone.js')









	


		
💖 Support further development

		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! 🙏😊

		


		


		

		


		


		@igorskyflyer

		


		


	






## 🕵🏼 Usage

Install it by executing:

```shell

npm i "@igor.dvlpr/node-clone-js"

```




## 🤹🏼 API

### Simple array copy

```javascript

import { clone } from '@igor.dvlpr/node-clone-js'

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 '@igor.dvlpr/node-clone-js'

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 '@igor.dvlpr/node-clone-js'

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 '@igor.dvlpr/node-clone-js'

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)

```

---

### Development

```shell

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

cd npm-clone-js

npm install

```

### Test

```shell

npm test

```

---

## 🪪 License

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

---

## 🧬 Related

[@igor.dvlpr/pathexists](https://www.npmjs.com/package/@igor.dvlpr/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. 🗺_

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

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

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

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

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

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

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

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







>

> Provided by **Igor Dimitrijević** (*@igorskyflyer*).

>