README.md
1.35 KB
jest-serializer
Module for serializing and deserializing object into memory and disk. By default, the v8
implementations are used, but if not present, it defaults to JSON
implementation. Both serializers have the advantage of being able to serialize Map
, Set
, undefined
, NaN
, etc, although the JSON one does it through a replacer/reviver.
Install
$ yarn add jest-serializer
API
Three kinds of API groups are exposed:
serialize
and deserialize
In-memory serialization: This set of functions take or return a Buffer
. All the process happens in memory. This is useful when willing to transfer over HTTP, TCP or via UNIX pipes.
import {deserialize, serialize} from 'jest-serializer';
const myObject = {
foo: 'bar',
baz: [0, true, '2', [], {}],
};
const buffer = serialize(myObject);
const myCopyObject = deserialize(buffer);
readFileSync
and writeFileSync
Synchronous persistent filesystem: This set of functions allow to send to disk a serialization result and retrieve it back, in a synchronous way. It mimics the fs
API so it looks familiar.
import {readFileSync, writeFileSync} from 'jest-serializer';
const myObject = {
foo: 'bar',
baz: [0, true, '2', [], {}],
};
const myFile = '/tmp/obj';
writeFileSync(myFile, myObject);
const myCopyObject = readFileSync(myFile);