@kingjs/copy

Copies own and inherited enumerable property values optionally skipping those already defined.

Stats

StarsIssuesVersionUpdatedCreatedSize
@kingjs/copy
1.0.33 years ago3 years agoMinified + gzip package size for @kingjs/copy in KB

Readme

@kingjs/copy

Copies own and inherited enumerable property values optionally skipping those already defined.

Usage

Copy properties from source to target like this:

var copy = require('@kingjs/copy');

var target = { 
  a: 0,
  b: 1, 
};

var source = { 
  b: 2,
  c: 3
};

copy(target, source); 

result:

{
  a: 0,
  b: 2,
  c: 3
}

API

declare function copy(
  target, 
  source?, 
  skipIfDefined?: boolean | (name) => boolean,
): any

Parameters

  • target: An object to which properties are copied.
  • source: An object whose properties are copied to target.
  • skipIfDefined: Prevent overwriting:
    • If true.
    • If a function that returns true given:
      • name: The name of the existing property.

        Returns

        Returns the target with properties copied from source.

        Remarks

        Inherited and own properties are copied.

Non-enumerable properties are not copied.

Install

With npm installed, run

$ npm install @kingjs/copy

License

MIT

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.