Serializer of Javascript data, with objects reconstruction
Find a file
2019-09-17 10:29:04 +02:00
src Normalized on tk-base 2019-09-13 13:57:21 +02:00
.editorconfig Normalized on tk-base 2019-09-13 13:57:21 +02:00
.gitignore Normalized on tk-base 2019-09-13 13:57:21 +02:00
.gitlab-ci.yml Added gitlab ci build 2019-09-17 10:29:04 +02:00
activate_node Normalized on tk-base 2019-09-13 13:57:21 +02:00
jest.config.js Normalized on tk-base 2019-09-13 13:57:21 +02:00
package-lock.json Added gitlab ci build 2019-09-17 10:29:04 +02:00
package.json Added gitlab ci build 2019-09-17 10:29:04 +02:00
README.md Update 'README.md' 2019-09-17 08:11:45 +00:00
tsconfig.json Normalized on tk-base 2019-09-13 13:57:21 +02:00

tk-serializer

About

This library offers a generic serialization system for Javascript.

Deep objects state may be serialized to a string, and reconstructed back.

Class instances are reconstructed properly, as long as they are in the provided namespace. Circular references are handled.

Be warned that resulting serialized value may be quite large.

Typescript definitions are included.

Issues can be reported on GitLab.

Install

Import in node:

npm install tk-serializer
import { Serializer } from "tk-serializer";

Import in browser:

<script src="https://unpkg.com/tk-serializer"></script>
const Serializer = tkSerializer.Serializer;

Use

Suppose you have 2 classes Class1 and Class2, whose instances you want to serialize:

const namespace = {
    Class1,
    Class2
};
const obj = {
    a: [1, "a", new Class1()],
    b: new Class2("x"),
    c: new Class3()
};

let serializer = new Serializer(namespace);

// Optionally, some class instances may be ignored (they will be replaced by *undefined*)
serializer.addIgnoredClass("Class3");

// Serialize the object to a string
let state = serializer.serialize(obj);

// Reconstruct the object back (*c* will be undefined)
let nobj = serializer.unserialize(state);