The fastest way to parse JSON safely
Clone or download
Latest commit c7389e4 Mar 21, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Initial commit Feb 22, 2016
.travis.yml Initial import. Feb 22, 2016
LICENSE Initial commit Feb 22, 2016
README.md Fix README example Mar 21, 2018
benchmark.js Fixed standard. Apr 13, 2016
package.json Added note about Node versions where this is useful. Jul 30, 2017
parse.js Initial import. Feb 22, 2016
test.js Initial import. Feb 22, 2016

README.md

fast-json-parse

Build Status

It is equivalent to json-parse-safe, but it set both the err and value property to null.

The reason why this is fast is that try/catch inhibits the functions in which you use them to be optimized. This assumption holds true up to Node 6, from Node 7 and forward this module is not useful anymore.

Install

npm i fast-json-parse --save

Usage

You can use it as a function or via a contructor, as you prefer.

function

'use strict'

var parse = require('fast-json-parse')
var fs = require('fs')

var result = parse(fs.readFileSync('./package.json', 'utf8'))

if (result.err) {
  console.log('unable to parse json', result.err.message)
} else {
  console.log('json parsed successfully', result.value)
}

constructor

'use strict'

var Parse = require('fast-json-parse')
var fs = require('fs')

var result = new Parse(fs.readFileSync('./package.json'))

if (result.err) {
  console.log('unable to parse json', result.err.message)
} else {
  console.log('json parsed successfully', result.value)
}

Acknowledgements

fast-json-parse is sponsored by nearForm.

License

MIT