Documentation

Seria is a serialization and deserialization library that goes beyond the conventional capabilities of JSON. It provides seamless handling for various data types, including those that JSON cannot handle directly.

This library is inspired on the new serialization capabilities react provides for server actions.

npm install seria

yarn add seria

pnpm add seria

import * as seria from "seria";

const json = seria.stringify(value);
const value = seria.parse(json);

Seria also supports encoding and decoding FormData:

import { encode, decode } from "seria/form-data";

const formData = encode(value);
const value = decode(formData);

Seria provides stream-based serialization and deserialization:

import * as seria from "seria";

const stream = seria.stringifyToStream(value);
const result = await seria.parseFromStream(stream);

If you serialize a value that contains any Promise you need to serialize using a stream or use seria.stringifyAsync which resolve all the promises.

Types supported by seria in comparison with the standard JSON object.

Typed Arrays https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Typed_arrays

File and FormData are supported on seria/form-data.

seria also handles:

• Infinity, -Infinity, NaN, -0
• Cyclical references: obj.self = obj
• Repeated references: [obj, new Set([obj]), new Map([["key", obj]])]
• Custom types using replacers and revivers

These libraries were used as references to improve seria features.

• devalue
• superjson