athea

Repositories Projects Packages

parse-json (5.2.0)

Published 2026-02-24 14:02:25 +00:00 by atheaadmin

Installation

Setup this registry in your project .npmrc file:

registry=

To install the package using npm, run the following command:

npm install parse-json@5.2.0

or add it to the package.json file:

"parse-json": "5.2.0"

For more information on the npm registry, see the documentation.

About this package

parse-json

Parse JSON with more helpful errors

Install

$ npm install parse-json

Usage

const parseJson = require('parse-json');

const json = '{\n\t"foo": true,\n}';


JSON.parse(json);
/*
undefined:3
}
^
SyntaxError: Unexpected token }
*/


parseJson(json);
/*
JSONError: Unexpected token } in JSON at position 16 while parsing near '{      "foo": true,}'

  1 | {
  2 |   "foo": true,
> 3 | }
    | ^
*/


parseJson(json, 'foo.json');
/*
JSONError: Unexpected token } in JSON at position 16 while parsing near '{      "foo": true,}' in foo.json

  1 | {
  2 |   "foo": true,
> 3 | }
    | ^
*/


// You can also add the filename at a later point
try {
	parseJson(json);
} catch (error) {
	if (error instanceof parseJson.JSONError) {
		error.fileName = 'foo.json';
	}

	throw error;
}
/*
JSONError: Unexpected token } in JSON at position 16 while parsing near '{      "foo": true,}' in foo.json

  1 | {
  2 |   "foo": true,
> 3 | }
    | ^
*/

API

parseJson(string, reviver?, filename?)

Throws a JSONError when there is a parsing error.

string

Type: string

reviver

Type: Function

Prescribes how the value originally produced by parsing is transformed, before being returned. See JSON.parse docs for more.

filename

Type: string

Filename displayed in the error message.

parseJson.JSONError

Exposed for instanceof checking.

fileName

Type: string

The filename displayed in the error message.

codeFrame

Type: string

The printable section of the JSON which produces the error.

---

Get professional support for this package with a Tidelift subscription
_{Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies.}

Dependencies

Dependencies

ID	Version
@babel/code-frame	^7.0.0
error-ex	^1.3.1
json-parse-even-better-errors	^2.3.0
lines-and-columns	^1.1.6

Development Dependencies

ID	Version
ava	^1.4.1
nyc	^14.1.1
xo	^0.24.0

Keywords

parse json graceful error message humanize friendly helpful string

Details

npm

2026-02-24 14:02:25 +00:00

0

Sindre Sorhus

Project Site

MIT

latest

2.5 KiB

Assets (1)

parse-json-5.2.0.tgz 2.5 KiB

Versions (1) View all

5.2.0 2026-02-24