npmpackage.info

Gathering detailed insights and metrics for realistic-structured-clone

Other packages similar to realistic-structured-clone

@mikeal/realistic-structured-clone

3.0.5

A pure JS implementation of the structured clone algorithm (or at least something pretty close to that)

Gathering detailed insights and metrics for realistic-structured-clone

realistic-structured-clone - 3.0.0 | npmpackage.info

realistic-structured-clone

A pure JS implementation of the structured clone algorithm (or at least something pretty close to that).

3.0.0

JavaScript

92.13 kB

2.3

Installations

npm install realistic-structured-clone

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

17.7.1

NPM Version

8.5.2 Pull Requests

Open

0

Total

5

Closed

0

Merged

5

Issues

Open

3

Total

7

Closed

4

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

dumbmatter

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

25 Stars

58 Commits

8 Forks

5 Watchers

3 Branches

4 Contributors

Updated on Apr 29, 2022

Maintainers

View All 4 Contributors

Package Meta Information

Latest Version

3.0.0

Package Id

realistic-structured-clone@3.0.0

Unpacked Size

92.13 kB

Size

21.92 kB

File Count

NPM Version

8.5.2

Node Version

17.7.1

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

domexception typeson typeson-registry

Dev Dependencies

babel-core babel-preset-es2015 babelify browserify derequire mocha

Realistic Structured Clone

You might not need this anymore! A native structuredClone function is available in many recent environments, such as Node v17 and Firefox v94. Check if your target environment has structuredClone built in. If it does, use that.

This is a pure JS implementation of the structured clone algorithm (or at least something pretty close to that).

Why do you want this? Well, you probably don't. If your goal is to just clone a JS object, you're better off with lodash's _.cloneDeep or the popular clone module on npm.

Let's try again... why do you want this? If you are making an implementation of an API that explicitly uses the structured clone algorithm (such as IndexedDB), then you want something that handles quirks and edge cases exactly like the structured clone algorithm. That's what realistic-structured-clone is for. It's not totally there (see below) but it's a decent start.

Use

Install through npm:

$ npm install realistic-structured-clone

Then use it:

// First load the module
// (Use Browserify or something if you're targeting the web)
var structuredClone = require('realistic-structured-clone');

// Clone a variable (will throw a DataCloneError for invalid input)
var clonedX = structuredClone(x);

Alternatives

If you look around, you'll notice various modules calling themselves implementations of the structured clone algorithm, such as the structured-clone package on npm. But that package, like all the others I've seen, doesn't actually seem to be an attempt at implementing the structured clone algorithm. It's just some arbitrary type of clone. As I wrote above, this distinction only matters if you really care about the nuances of the structured clone algorithm, which you probably don't.

If you're working in the browser, you can do something like this to do a real structured clone:

function clone(x) {
    return new Promise(function (resolve, reject) {
        window.addEventListener('message', function(e) {
            resolve(e.data);
        });
        window.postMessage(x, "*");
    });
}
var x = {a:[1,2,3], b:{c:1}};
clone(x).then(function(cloned) {
    console.log("x: %s", JSON.stringify(x));
    console.log("cloned: %s", JSON.stringify(cloned));
    console.log("x == cloned %s", x == cloned);
    console.log("x === cloned %s", x === cloned);
});

However, that won't help you in Node.js. It's also asynchronous, which could be a problem. realistic-structured-clone is synchronous and works everywhere.

Current State

As of version 2.0, it should be pretty damn close to the spec! However it is now just a light wrapper around the Typeson structured-cloning-throwing preset.

License

Apache 2.0

No vulnerabilities found.

10

Binary-Artifacts

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

10

Dangerous-Workflow

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

1

Code-Review

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

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

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

0

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

Security-Policy

Determines if the project has published a security policy.

0

License

Determines if the project has defined a license.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.3

/10

Last Scanned on 2025-07-07

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.

Learn More