projecte_ionic/node_modules/copy-anything
janmaroto b12369cb47 Conexio amb la api 2022-02-09 18:30:03 +01:00
..
.github Conexio amb la api 2022-02-09 18:30:03 +01:00
build Conexio amb la api 2022-02-09 18:30:03 +01:00
dist Conexio amb la api 2022-02-09 18:30:03 +01:00
src Conexio amb la api 2022-02-09 18:30:03 +01:00
test Conexio amb la api 2022-02-09 18:30:03 +01:00
types Conexio amb la api 2022-02-09 18:30:03 +01:00
.eslintignore Conexio amb la api 2022-02-09 18:30:03 +01:00
.eslintrc.js Conexio amb la api 2022-02-09 18:30:03 +01:00
.prettierrc Conexio amb la api 2022-02-09 18:30:03 +01:00
LICENSE Conexio amb la api 2022-02-09 18:30:03 +01:00
README.md Conexio amb la api 2022-02-09 18:30:03 +01:00
package.json Conexio amb la api 2022-02-09 18:30:03 +01:00
tsconfig.json Conexio amb la api 2022-02-09 18:30:03 +01:00

README.md

Copy anything 🎭

npm i copy-anything

An optimised way to copy'ing (cloning) an object or array. A small and simple integration.

Motivation

I created this package because I tried a lot of similar packages that do copy'ing/cloning. But all had its quirks, and all of them break things they are not supposed to break... 😞

I was looking for:

  • a simple copy/clone function
  • has to be fast!
  • props must lose any reference to original object
  • works with arrays and objects in arrays!
  • supports symbols
  • can copy non-enumerable props as well
  • does not break special class instances ‼️

This last one is crucial! So many libraries use custom classes that create objects with special prototypes, and such objects all break when trying to copy them inproperly. So we gotta be careful!

copy-anything will copy objects and nested properties, but only as long as they're "plain objects". As soon as a sub-prop is not a "plain object" and has a special prototype, it will copy that instance over "as is". ♻️

Meet the family

Usage

import { copy } from 'copy-anything'

const original = { name: 'Ditto', type: { water: true } }
const copy = copy(original)

// now if we change a nested prop like the type:
copy.type.water = false
copy.type.fire = true(
  // new prop

  // then the original object will still be the same:
  original.type.water === true
)(original.type.fire === undefined)

Please note, by default copy-anything does not copy non-enumerable props. If you need to copy those, see the instructions further down below.

Works with arrays

It will also clone arrays, as well as objects inside arrays! 😉

const original = [{ name: 'Squirtle' }]
const copy = copy(original)

// now if we change a prop in the array like so:
copy[0].name = 'Wartortle'
copy.push({ name: 'Charmander' })(
  // new item

  // then the original array will still be the same:
  original[0].name === 'Squirtle'
)(original[1] === undefined)

Non-enumerable

By default, copy-anything only copies enumerable properties. If you also want to copy non-enumerable properties you can do so by passing that as an option.

const original = { name: 'Bulbasaur' }
// bulbasaur's ID is non-enumerable
Object.defineProperty(original, 'id', {
  value: '001',
  writable: true,
  enumerable: false,
  configurable: true,
})
const copy1 = copy(original)
const copy2 = copy(original, { nonenumerable: true })(copy1.id === undefined)(copy2.id === '001')

Limit to specific props

You can limit to specific props.

const original = { name: 'Flareon', type: ['fire'], id: '136' }
const copy = copy(original, { props: ['name'] })(copy === { name: 'Flareon' })

Please note, if the props you have specified are non-enumerable, you will also need to pass {nonenumerable: true}.

Source code

The source code is literally just these lines. Most of the magic comes from the isPlainObject function from the is-what library.

import { isPlainObject } from 'is-what'

export function copy (target) {
  if (isArray(target)) return target.map(i => copy(i))
  if (!isPlainObject(target)) return target
  return Object.keys(target)
    .reduce((carry, key) => {
      const val = target[key]
      carry[key] = copy(val)
      return carry
    }, {})
}