budibase/packages/common/node_modules/jest-serializer
Martin McKeaveney 0430cd11b1 building out new budibase API 2020-04-15 15:23:29 +01:00
..
build building out new budibase API 2020-04-15 15:23:29 +01:00
LICENSE building out new budibase API 2020-04-15 15:23:29 +01:00
README.md building out new budibase API 2020-04-15 15:23:29 +01:00
package.json building out new budibase API 2020-04-15 15:23:29 +01:00
v8.d.ts building out new budibase API 2020-04-15 15:23:29 +01:00

README.md

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:

In-memory serialization: serialize and deserialize

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);

Synchronous persistent filesystem: readFileSync and writeFileSync

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);