fast-json

A lightning fast on the fly JSON parser able to return JSON values and structures from plain JSON as String or Buffer. It's much faster than JSON.parse() and doesn't require any extra memory allocation for the data processed.

Install

npm install fast-json

Usage

1const { FastJson } = require('fast-json');
2
3const data = JSON.stringify({
4  ireland: {
5    people: [{ name: 'Alex' }, { name: 'John' }, { name: 'Cian' }],
6  },
7  spain: {
8    people: [{ name: 'Antonio' }, { name: 'Juan' }, { name: 'Pedro' }],
9  },
10});
11
12const fastJson = new FastJson();
13
14// Path is a string representing a javascript object path
15fastJson.on('ireland.people', (value) => {
16  console.log('ireland.people ->', value);
17});
18
19// Paths can be also an array of keys
20fastJson.on(['spain', 'people', '1', 'name'], (value) => {
21  console.log(['spain', 'people', '1', 'name'], '->', value);
22});
23
24// Wildcards can be used to match all items in object or array
25fastJson.on('spain.people[*].name', (value) => {
26  console.log('spain.people[*].name ->', value);
27});
28
29fastJson.on('*.people[*].name', (value) => {
30  console.log('*.people[*].name ->', value);
31});
32
33fastJson.write(data);
34// The JSON can be string or Buffer
35// fastJson.write(Buffer.from(data))

1fastJson.on('ireland.people[1].name', (value) => {
2  console.log('ireland.people[1].name ->', value);
3  // Once we have all we need, we can skip the rest of the JSON to improve performance.
4  fastJson.skip();
5});

1// Path separator defines the keys separator on the listeners
2const fastJson = new FastJson({ pathSeparator: '/' });
3
4// In this case it allows keys having dots by using a different separator
5fastJson.on('unknown.country/people/0/name', (value) => {
6  console.log('unknown.country/people/0/name ->', value);
7});

Performance

JSON file citylots.json of 189MB from https://github.com/zemirco/sf-city-lots-json.

• fast-json: 0.56s / 198MB RAM
• JSON.parse: 1.8s / 640MB RAM
• jsonparse: 15.0s / 1,100MB RAM (Only reading, it wasn't able to return a value)

TODO

• [Feature] Allow chunked JSON.
• [Feature] Match more glob patters.
• [Feature] Add more flexibility to event listeners (on, once, off, etc).
• [Documentation] Create branch gh-pages using jsdoc.
• [Documentation] More real life testing and examples.