# @hyurl/structured-clone > A cheap way to clone typed data for serialization. Latest version **0.3.0** (published 2020-11-25) · MIT license · 0 weekly downloads > **Deprecated.** This package is deprecated. ## Install ```sh npm install @hyurl/structured-clone pnpm add @hyurl/structured-clone yarn add @hyurl/structured-clone bun add @hyurl/structured-clone ``` ## Health **Score 10/100 (F)** — status: deprecated. Negative: deprecated. ## Facts | | | |---|---| | Version | 0.3.0 | | Published | 2020-11-25 | | First published | 2019-12-22 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 0 | | Unpacked size | 43.1 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Author | A-yon Lee | | Maintainers | hyurl | | Keywords | clone, structure, json | ## Links - npm: https://www.npmjs.com/package/@hyurl/structured-clone - Repository: https://github.com/hyurl/structured-clone - Homepage: https://github.com/hyurl/structured-clone#readme - Issues: https://github.com/hyurl/structured-clone/issues - npm.io page: https://npm.io/package/@hyurl/structured-clone ## Alternatives - [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads - [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads - [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads - [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads - [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads ## Recent versions - 0.3.0 (latest) — 2020-11-25 - 0.2.8 — 2020-10-17 - 0.2.7 — 2020-10-17 - 0.2.6 — 2020-09-21 - 0.2.5 — 2020-09-08 - 0.2.4 — 2020-05-26 - 0.2.3 — 2020-05-25 - 0.2.2 — 2020-04-27 - 0.2.1 — 2020-02-24 - 0.2.0 — 2020-02-23 - 0.1.6 — 2020-02-06 - 0.1.5 — 2020-02-06 - 0.1.4 — 2019-12-23 - 0.1.3 — 2019-12-23 - 0.1.2 — 2019-12-23 - … 2 more at https://npm.io/package/@hyurl/structured-clone/versions ## README # Structured Clone **A cheap way to clone typed data for serialization.** Using this module, a program can safely clone data from an object for serialization by using JSON or HTML Structured Clone Algorithm, that means all functions, symbols, circular references, and any other elements that are not compatible with these algorithms will be auto-removed silently. Additionally, this module also composes the clone object into a structured format for JSON serialization, so it could be used to serialize compound types like Date, RegExp, etc. The types that supported by HTML Structured Clone Algorithm (in Node.js term) are also supported by JSON along with this module. This module is designed primarily in order to safely clone data that can be transferred across processes or threads in Node.js, however, it works in modern browsers and [Deno](https://deno.land) as well. ## API - `compose(data: any, forHTML = false)` Composes the data into a well-formatted object that can be serialized via JSON or HTML Structured Clone Algorithm. If `forHTML` is omitted, this function returns a copy of data in a form that combined types and values (only for compound types), so that they can be serialized and transferred in JSON just like HTML Structured Clone Algorithm does. - `decompose(data: any)` Decomposes the formatted data back to its original form. - `serialize(data: any): string` Equivalent to `JSON.stringify(compose(data))`. - `deserialize(json: string): any` Equivalent to `decompose(JSON.parse(json))`. - `createComposer(make: (type: string, value: any) => any): (data: any, forHTML?: boolean) => any` This function could be used to create a customized composer function. - `createDecomposer(parse: (data: any) => { type: string, value: any }, checkSignature: (data: any) => boolean): (data: any) => any` This function could be used to create a customized decomposer function. - `utils` Some utility functions used to process data: - `error2object(err: Error): object` Transfers an error instance to a standard object. - `object2error(obj: object): Error` Transfers a standard object to an error instance. - `walkToJSON(data: any): any` Recursively calls `toJSON()` method in the data and its children nodes until drain. ## Example ```js import { compose, decompose } from "@hyurl/structured-clone"; import { format } from "util"; let data = { ok: true, greeting: "Hello, World!", times: 100, largeTimes: 1000000000n, // BigInt is supported if the runtime supports it. maxTimes: Infinity, guests: new Map([ [ 10000, { name: "Mr. Wong", tel: NaN, roles: new Set([1, 2, 3]) } ], [ 10001, { name: "Mrs. Wong", tel: NaN, roles: new Set([2, 3]) } ] ]), date: new Date(), pattern: /H(ello|i), \w+/i, err: new Error("Excuse me"), // Other errors are as well supported. packet: new TextEncoder().encode("Hello, World!"), // TypedArray // Other Types like ArrayBuffer and ArrayBufferView are also supported, // however, Buffer are only supported by Node.js with JSON serialization, // setting `forHTML` will transfer Buffer into Uint8Array automatically. }; // Create copy and serialize let copy = compose(data); let json = JSON.stringify(copy); // Parse serialized data and decompose to the original form. let _copy = JSON.parse(json); let _data = decompose(_copy); // The two copy of data are literally the same. // (However with different object reference.) console.assert(format(data) === format(_data)); console.log(json); // Will seem like: // {"ok":true,"greeting":"Hello, World!","times":100,"largeTimes":["[[BigInt]]", // "1000000000"],"maxTimes":["[[Number]]","Infinity"],"guests":["[[Map]]", // [[10000,{"name":"Mr. Wong","tel":["[[Number]]","NaN"] ... ``` ## In Deno ```ts import { compose, decompose } from "https://raw.githubusercontent.com/hyurl/structured-clone/master/lib/index.js"; ``` --- _Source: https://npm.io/package/@hyurl/structured-clone · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._