json-bigint

The symmetrical, backward compatible, and unambiguous JSON serializer/parser with bigint support.

npm install --save @smikhalevski/json-bigint

Usage

Integers from JSON are parsed as BigInt while float numbers are parsed as number.

import * as JsonBigInt from '@smikhalevski/json-bigint';

JsonBigInt.stringify({foo: 123n, bar: 123}); // → '{"foo":123,"bar":123.0}'

JsonBigInt.parse('{"foo":123,"bar":123.0}'); // → {foo: 123n, bar: 123}

You can create custom parsers and serializers:

import bigint from 'bigint';
import {createJsonParser, createJsonStringifier} from '@smikhalevski/json-bigint';

const stringifyJson = createJsonStringifier({
  isBigInt: (value) => value instanceof bigint,
  stringifyBigInt: (value) => value.toString(),
});

const parseJson = createJsonParser({
  parseBigInt: (str) => bigint(str),
});

stringifyJson({foo: bigint(123), bar: 123}); // → '{"foo":123,"bar":123.0}'

parseJson('{"foo":123,"bar":123.0}'); // → {foo: bigint(123), bar: 123}

Performance

Clone this repo and use npm ci && npm run perf to run the performance testsuite.

Results are in operations per second. The higher number is better.

| | native JSON | @smikhalevski/json-bigint | @sidorares/json-bigint | | --------- | ---: | ---: | ---: | | parse | 49 352 | 15 136 | 8 874 | | stringify | 55 066 | 27 529 | 17 210 |