npmpackage.info

Gathering detailed insights and metrics for @visulima/deep-clone

Gathering detailed insights and metrics for @visulima/deep-clone

@visulima/deep-clone

Visulima is the next-gen JavaScript framework for JAMStack blogs, sites & apps.

2.1.7

12

MIT

TypeScript

54.68 kB

Installations

npm install @visulima/deep-clone

Developer Guide

BETA

Typescript

Yes

Module System

ESM

Min. Node Version

>=18.* <=23.*

Node Version

18.20.5

NPM Version

9.6.7

Score

69.2

Supply Chain

94.4

Quality

86.4

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

9

Total

464

Closed

138

Merged

317

Issues

Open

5

Total

18

Closed

13

Releases

967

@visulima/package@3.2.0

@visulima/package@3.2.0

Published on 16 Dec 2024

@visulima/cerebro@1.1.26

@visulima/cerebro@1.1.26

Published on 12 Dec 2024

@visulima/pail@2.1.12

@visulima/pail@2.1.12

Published on 12 Dec 2024

@visulima/api-platform@3.0.27

@visulima/api-platform@3.0.27

Published on 12 Dec 2024

@visulima/jsdoc-open-api@2.0.65

@visulima/jsdoc-open-api@2.0.65

Published on 12 Dec 2024

@visulima/find-cache-dir@1.0.16

@visulima/find-cache-dir@1.0.16

Published on 12 Dec 2024

View all 967 releases

Contributors

2

View all 2 contributors

Languages

6

TypeScript

JavaScript

MDX

Handlebars

CSS

Shell

TypeScript (91.8%)

JavaScript (5.89%)

MDX (1.66%)

Handlebars (0.39%)

CSS (0.14%)

Shell (0.12%)

Developer

Download Statistics

Total Downloads

3,644

Last Day

3

Last Week

47

Last Month

468

Last Year

2,969

GitHub Statistics

12 Stars

2,205 Commits

3 Forks

2 Watching

16 Branches

2 Contributors

Sponsor this package

https://github.com/sponsors/prisis https://anolilab.com/support

Maintainers

1

Package Meta Information

Latest Version

2.1.7

Package Id

@visulima/deep-clone@2.1.7

Unpacked Size

54.68 kB

Size

15.65 kB

File Count

46

NPM Version

9.6.7

Node Version

18.20.5

Publised On

12 Dec 2024

Total Downloads

Cumulative downloads

Total Downloads

3,644

Last day

-88.9%

3

Compared to previous day

Last week

-75.9%

47

Compared to previous week

Last month

-18.3%

468

Compared to previous month

Last year

339.9%

2,969

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Versions

Visulima Deep Clone

Really Fast Deep Clone.

^{Daniel Bannert's open source work is supported by the community on GitHub Sponsors}

Install

1npm install @visulima/deep-clone

1yarn add @visulima/deep-clone

1pnpm add @visulima/deep-clone

Usage

Copy or deep clone an input value to an arbitrary depth. The function accepts both objects and primitives.

1import deepClone from "@visulima/deep-clone";
2
3const cloned = deepClone({ a: 1, b: { c: 2 } });
4
5console.log(cloned); // => {a: 1, b: {c: 2}}

API

deepClone(input, options?)

input

Type: any

The input value to copy.

options

Type: object

strict

Type: boolean

Default: false

If true, it will copy all properties, including non-enumerable ones and symbols.

handlers

Type: object

A set of custom handlers for specific type of value. Each handler is a function that takes the original value and returns a new value or throws an error if the value is not supported.

Array: InternalHandler<unknown[]>;
ArrayBuffer: InternalHandler;
Blob: InternalHandler;
DataView: InternalHandler;
Date: InternalHandler;
Error: InternalHandler;
Float32Array: InternalHandler;
Float64Array: InternalHandler;
Int8Array: InternalHandler;
Int16Array: InternalHandler;
Int32Array: InternalHandler;
Map: InternalHandler<Map<unknown, unknown>>;
Object: InternalHandler<Record<string, unknown>>;
Promise: InternalHandler<Promise>;
RegExp: InternalHandler;
Set: InternalHandler<Set>;
WeakMap: InternalHandler<WeakMap<any, unknown>>;
WeakSet: InternalHandler<WeakSet>;

Utils

copyOwnProperties(input)

Copy all properties contained on the object.

1import { copyOwnProperties } from "@visulima/deep-clone/utils";
2
3const obj = { a: 1, b: 2 };
4
5const copy = copyOwnProperties(obj);
6
7console.log(copy); // => {a: 1, b: 2}

getCleanClone(input)

Get an empty version of the object with the same prototype it has.

1import { getCleanClone } from "@visulima/deep-clone/utils";
2
3const obj = { a: 1, b: 2 };
4
5const clean = getCleanClone(obj);
6
7console.log(clean); // => {}

Notes

List of supported values/types:
- undefined (original value is returned)
- null (original value is returned)
- boolean/Boolean (original value is returned)
- string/String (original value is returned)
- number/Number (original value is returned)
- function
- Object
- Date
- RegExp
- Set
- Map
- Error
- URIError
- ReferenceError
- SyntaxError
- RangeError
- EvalError
- TypeError
- System Error (Node.js)
- Array
- Int8Array
- Uint8Array
- Uint8ClampedArray
- Init16Array
- Uint16Array
- Int32Array
- Uint32Array
- Float32Array
- Float64Array
- Buffer (Node.js)
- DataView
- Blob
List of unsupported values/types:
- DOMElement: to copy DOM elements, use element.cloneNode().
- Symbol
- WeakMap
- WeakSet
- File
- FileList
- ImageData
- ImageBitmap
- Promise
- SharedArrayBuffer
The implementation can handle circular references.
If a Number, String, or Boolean object is encountered, the value is cloned as a primitive. This behavior is intentional. The implementation is opinionated in wanting to avoid creating numbers, strings, and booleans via the new operator and a constructor.
The implementation only checks whether basic Objects, Arrays, and class instances are extensible, sealed, and/or frozen.
functions are not cloned; their reference is copied.
The implementation supports custom error types which are Error instances (e.g., ES2015 subclasses).

Benchmarks

Note:

It is true that jsondiffpatch.clone() from jsondiffpatch is faster than @visulima/deep-clonse in this particular benchmark, but it cannot handle as many situations as @visulima/deep-clonse can.

It is true that fastest-json-copy is faster than @visulima/deep-clonse in this particular benchmark. Also, fastest-json-copy has such huge limitations that it is rarely useful. For example, it treats things like Date and Map instances the same as empty {}. It can't handle circular references.

plain-object-clone is also really limited in capability.

Supported Node.js Versions

Libraries in this ecosystem make the best effort to track Node.js’ release schedule. Here’s a post on why we think this is important.

Contributing

If you would like to help take a look at the list of issues and check our Contributing guild.

Note: please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Credits

License

The visulima deep-clone is open-sourced software licensed under the MIT

Empty State

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Contributors

Determines if the project has a set of contributors from multiple organizations (e.g., companies).

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Dependency-Update-Tool

Determines if the project uses a dependency update tool.

10

License

Determines if the project has defined a license.

10

Maintained

Determines if the project is "actively maintained".

10

SAST

Determines if the project uses static code analysis.

8

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

Reason

detected GitHub workflow tokens with excessive permissions

Details

Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:34
Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql.yml:33
Warn: jobLevel 'contents' permission set to 'write': .github/workflows/lock-file-maintenance.yml:20
Warn: jobLevel 'contents' permission set to 'write': .github/workflows/preview-release.yaml:22
Warn: jobLevel 'checks' permission set to 'write': .github/workflows/preview-release.yaml:24
Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/require-allow-edits.yml:11
Info: jobLevel 'contents' permission set to 'read': .github/workflows/scorecards.yml:31
Info: jobLevel 'actions' permission set to 'read': .github/workflows/scorecards.yml:32
Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/semantic-pull-request.yml:21
Warn: no topLevel permission defined: .github/workflows/allo-allo.yaml:1
Warn: no topLevel permission defined: .github/workflows/cache-clear.yml:1
Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:24
Info: topLevel 'contents' permission set to 'read': .github/workflows/comment-issue.yml:9
Info: topLevel 'contents' permission set to 'read': .github/workflows/dependency-review.yml:17
Info: topLevel 'contents' permission set to 'read': .github/workflows/lint.yml:16
Info: topLevel 'contents' permission set to 'read': .github/workflows/lock-file-maintenance.yml:12
Warn: no topLevel permission defined: .github/workflows/lock-issues.yaml:1
Info: topLevel 'contents' permission set to 'read': .github/workflows/preview-release.yaml:8
Info: topLevel 'contents' permission set to 'read': .github/workflows/require-allow-edits.yml:6
Info: topLevel permissions set to 'read-all': .github/workflows/scorecards.yml:20
Info: topLevel 'contents' permission set to 'read': .github/workflows/semantic-pull-request.yml:15
Info: topLevel 'contents' permission set to 'read': .github/workflows/semantic-release.yml:17
Warn: no topLevel permission defined: .github/workflows/stale-issues.yml:1
Info: topLevel 'contents' permission set to 'read': .github/workflows/test.yml:16

Score

6.2

/10

Last Scanned on 2024-12-24T07:27:21Z

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.