lxsmnsyc / seroval Goto Github PK

View Code? Open in Web Editor NEW

469.0 5.0 4.0 2.31 MB

Stringify JS values

Home Page: https://seroval.vercel.app

License: MIT License

JavaScript 0.43% TypeScript 95.61% HTML 3.96%

seroval's Introduction

seroval

Stringify JS values

Install

npm install --save seroval

yarn add seroval

pnpm add seroval

Usage

import { serialize } from 'seroval';

const object = {
  number: [Math.random(), -0, NaN, Infinity, -Infinity],
  string: ['hello world', '<script>Hello World</script>'],
  boolean: [true, false],
  null: null,
  undefined: undefined,
  bigint: 9007199254740991n,
  array: [,,,], // holes
  regexp: /[a-z0-9]+/i,
  date: new Date(),
  map: new Map([['hello', 'world']]),
  set: new Set(['hello', 'world']),
};

// self cyclic references
// recursive objects
object.self = object;
// recursive arrays
object.array.push(object.array);
// recursive maps
object.map.set('self', object.map);
// recursive sets
object.set.add(object.set);

// mutual cyclic references
object.array.push(object.map);
object.map.set('mutual', object.set);
object.set.add(object.array);

const result = serialize(object);
console.log(result);

Output (as a string):

((h,j,k,m,o)=>(o={number:[0.5337763749243287,-0,0/0,1/0,-1/0],string:["hello world","\x3Cscript>Hello World\x3C/script>"],boolean:[!0,!1],null:null,undefined:void 0,bigint:9007199254740991n,array:h=[,,,,k=(j=[],new Map([["hello","world"],["mutual",m=new Set(["hello","world"])]]))],regexp:/[a-z0-9]+/i,date:new Date("2023-12-07T17:28:57.909Z"),map:k,set:m},h[3]=h,k.set("self",k),m.add(m).add(h),o.self=o,o))()

// Formatted for readability
((h, j, k, m, o) => (
  (o = {
    number: [0.5337763749243287, -0, 0 / 0, 1 / 0, -1 / 0],
    string: ["hello world", "\x3Cscript>Hello World\x3C/script>"],
    boolean: [!0, !1],
    null: null,
    undefined: void 0,
    bigint: 9007199254740991n,
    array: (h = [
      ,
      ,
      ,
      ,
      (k =
        ((j = []),
        new Map([
          ["hello", "world"],
          ["mutual", (m = new Set(["hello", "world"]))],
        ]))),
    ]),
    regexp: /[a-z0-9]+/i,
    date: new Date("2023-12-07T17:28:57.909Z"),
    map: k,
    set: m,
  }),
  (h[3] = h),
  k.set("self", k),
  m.add(m).add(h),
  (o.self = o),
  o
))();

Docs

License

MIT © lxsmnsyc

seroval's People

Contributors

Stargazers

Watchers

Forkers

samualtnorman direisc sep2 tianjianjun0727

seroval's Issues

serialise date to number instead of string

surely it's better to serialise a date to the format new Date(1682085024851) instead of new Date("2023-04-21T13:50:24.851Z")?

the number is smaller and the string needs parsing.

I might be wrong though and there's something I'm missing. I'm curious if that's the case.

Thanks.

Objects that are iterable, Promise-like, null constructor and Object constructor are currently exclusive from one another. Maybe there's a way to serialize them in a way that the entire behavior is combined.

Edge Case: Mistake on isolating Map entries

const a = {
  d: {},
  map: new Map,
  b: {
    c: {
      foo: 'bar'
    }
  }
};

a.map.set(a, a.b.c);

a.b.c.parent = a.b;
a.b.c.d = a.d;

This causes a.b.c to be undefined because the origin reference, located at a.map, is deferred due to recursion.

Feature: well-known symbols

Add support for well-known symbols

Add support for Generator and AsyncGenerator

Support for Class

Is it possible to support class?

Feature: Structured Clone Algorithm

Add support for Structured Clone Algorithm but mainly on types that only exists in the majority of JS Runtimes (either by native support or polyfill):

Potentially:

serialize 0x prefix string object key as number

Encountered this while using SolidStart.

When object string key contains 0x prefix it gets serialised as hex number.

For context, address identifiers in crypto such as Ethereum are commonly hex addresses.

import { deserialize, serialize } from "seroval"

const original = {
  "0x1": 2
}

const output = serialize(original)
console.log("output", output)
// output ({0x1:2})

const result = deserialize(output)
console.log("deserialize", result)
// deserialize { '1': 2 }

Feature: JSON string serializer

Add toJSONString and fromJSONString to skip the use of JSON.stringify and JSON.parse in userland (also because JSON.stringify has some bottleneck)

Better serialization for `Blob` and `File`

Currently Blob and File relies on ArrayBuffer serialization, which means it uses the Uint8Array indirectly. This serialization form is accurate, but is probably too large for consideration. Blob accepts Uint8Array, ArrayBuffer, DataView and string, so it's probably ideal if the string format can be utilized instead.

Feature: Streaming

Add streaming option for emitting serialized Promises

Inside of getCrossReferenceHeader script, getting error Uncaught SyntaxError: Unexpected identifier '_$HY'

I am trying Solid-js 1.8.3 and renderToStringAsync, and I got a hydration script injected with an error like below:

                               | Uncaught SyntaxError: Unexpected identifier '_$HY'
                               V
(self.$R=self.$R||{})["s2-"]=[]_$HY.r["s2-0-0-0-0-0-0"]=($R=>($R[0]=_$.P()))($R["s2-"]);($R=>(_$.Ps($R[0],!0)))($R["s2-"]);

After I added the semicolon here, the hydration script could be parsed by the browser:

(self.$R = self.$R || {})["s2-"] = [];
_$HY.r["s2-0-0-0-0-0-0"] = (($R) => ($R[0] = _$.P()))($R["s2-"]);
(($R) => _$.Ps($R[0], !0))($R["s2-"]);

Maybe there is a missing semicolon here? I noticed that the id == null has a semicolon included but the id != null case does not have a semicolon at the end.

export function getCrossReferenceHeader(id?: string): string {
  if (id == null) {
    return `self.${GLOBAL_CONTEXT_REFERENCES}=self.${GLOBAL_CONTEXT_REFERENCES}||[];`;
  }
- return `(self.${GLOBAL_CONTEXT_REFERENCES}=self.${GLOBAL_CONTEXT_REFERENCES}||{})["${serializeString(id)}"]=[]`;
+ return `(self.${GLOBAL_CONTEXT_REFERENCES}=self.${GLOBAL_CONTEXT_REFERENCES}||{})["${serializeString(id)}"]=[];`;
}

An unhandled error occured: Error: Cannot serialize function without reference ID

An unhandled error occured: Error: Cannot serialize function without reference ID.
at Y.parse (file:///node_modules/.pnpm/[email protected]/node_modules/seroval/dist/esm/production/index.mjs:3:38620)

n.push(this.parse(g)))

Custom serialization API

nuff said

Feature: Global identities

Add support for global identities

More support

Web API

Allow opting out of serialization

If possible, it'll be pretty convenient to mark some value to be not serialized. Imagine this arbitrary API:

import { serialize, NoSerialization } from "seroval";

console.log(serialize({
  title: "My Article",
  load: new NoSerialization(() => import("./my-article.mdx")),
})) // { title: "My Article" }

In this case, without NoSerialization, the load property should've filtered first not to make any serialization error, since anonymous functions are not serializable. However, because it's marked as NoSerialization, Seroval can just skip the serialization and remove the property.