Skip to content
/ json Public

Parse and stringify non-standards-compliant JSON

License

Notifications You must be signed in to change notification settings

TurboWarp/json

Repository files navigation

@turbowarp/json

This library is intended to parse and stringify non-standards-compliant JSON:

  • Parser and stringifier support Infinity, -Infinity, and NaN
  • Parser supports comments with // ... and /* ... */
  • Parser supports trailing commas
  • Parser supports extra ignored data after the end of the JSON value

Install from npm:

npm install @turbowarp/json

Then pick your favorite way to import it:

import {parse, stringify} from '@turbowarp/json';
import * as ExtendedJSON from '@turbowarp/json';
const ExtendedJSON = require('@turbowarp/json');

Note that there is no default export, so import ExtendedJSON from '@turbowarp/json'; might not work.

parse() parses a JSON string. It will first try to use JSON.parse, and falls back to our custom JSON parser if that fails. JSON.parse's reviver argument is not supported.

_parse() is also exported. It skips trying to use JSON.parse and always uses our custom JSON parser.

stringify() converts a JSON object to a string. Does not support JSON.stringify's replacer or space arguments. The resulting string is always fully minimized.

Our custom JSON parser and stringifier are not particularly optimized, but they are probably fast enough. The native JSON parser and stringifier are substantially faster than our custom ones.