NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #1006 most downloaded on npm
Scanner and parser for JSON with comments.
Latest stable
3.3.1
Last release 5 months ago
16 Jun 2026
Release timing varies
gaps range from 2 months to 1.7 years
Some releases are documented
notes for 14 of 36 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
39 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
This list of changes was auto generated.
modify() when removing last array elementThis list of changes was auto generated.
This list of changes was auto generated.
modify() when removing last array elementThis list of changes was auto generated.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This list of changes was auto generated.
This list of changes was auto generated.
undefined on empty string input#90: prepare 3.3.0
#88: Allow the visitor to cease callbacks
#89: Bump braces from 3.0.2 to 3.0.3 <details><summary><b>See More</b></summary>
#84: prepare 3.2.1
#81: perf(format): cache breaklines and spaces as much as possible
#79: update dependencies
#75: ci: add batch
#72: delete pr-chat action
#71: add publish pipeline & cleanup ci
#70: set preserveConstEnums: true, switch to es2020
#69: sort edits in applyEdits
#66: An additional parameter keepLines has been added into the formatting options which allows to keep the original line formatting
#64: Adding Microsoft SECURITY.MD
#62: Add JSON path supplier parameter to visitor functions
#44: findNodeAtLocation does not handle incomplete property pair
#61: Update API section in README
#53: Clarify whether / how Edit[] can be concatenated
#46: Non-standard whitespace handling
#47: Improve README
#54: readme: improve ParseOptions documentation
#43: Add file extenstion to typings property value
#34: Optimize parseLiteral for number-heavy JSON files (ala GeoJSON)
#39: Bump lodash from 4.17.15 to 4.17.19
#35: Allow for array modifications, add inPlace formatting option.
#32: Parse errors make parsed tree useless
#31: Upgrading from 2.1.1 to 2.2.0 has diagnostic for file with only comments
#25: Fix typo in README
#24: parse function should include properties with empty string as their keys
#21: Update README.md
#18: JavaScipt -> JavaScript
#17: add line and column information to scanner and visitor
#15: Fix a few typos in doc comments
#12: Do not mutate the given path
#9: Refactor computeIndentLevel method
#8: Fix typo of token
#6: Allow trailing commas in array
#5: add JSON formatter and editor from VS Code
#1: Error objects should also contain location information
This list of changes was auto generated.</details>
JSONVisitor.onObjectBegin and JSONVisitor.onArrayBegin can now return false to instruct the visitor that no children should be visited.prepare 3.2.1
prepare 3.2.1 (#84)
set preserveConstEnums: true , switch to es2020
set preserveConstEnums: true, switch to es2020 (#70)
es2020.const enum values in the bundled JavaScript files (ScanError, SyntaxKind, ParseErrorCode).An additional parameter keepLines has been added into the formatting …
An additional parameter keepLines has been added into the formatting …
FormattingOptions.keepLines : It leaves the initial line positions in the formatting.fixed API spec for parseTree. Can return undefine for empty input.
parseTree. Can return undefine for empty input.
FormattingOptions.insertFinalNewline.Nothing published for this version
new API ModificationOptions.isArrayInsertion: If JSONPath refers to an index of an array and isArrayInsertion is true, then modify will insert a new i
ModificationOptions.isArrayInsertion: If JSONPath refers to an index of an array and isArrayInsertion is true, then modify will insert a new item at that location instead of overwriting its contents.
ModificationOptions.formattingOptions is now optional. If not set, newly inserted content will not be formatted.Nothing published for this version
added ParseOptions.allowEmptyContent. Default is false.
ParseOptions.allowEmptyContent. Default is false.
getNodeType: Returns the type of a value returned by parse.parse: Fix issue with empty property nameNothing published for this version
JSONScanner and JSONVisitor return lineNumber / character.
JSONScanner and JSONVisitor return lineNumber / character.Nothing published for this version
Nothing published for this version
Nothing published for this version
renamed Node.columnOffset to Node.colonOffset
Node.columnOffset to Node.colonOffset
getNodePath: Gets the JSON path of the given JSON DOM nodefindNodeAtOffset: Finds the most inner node at the given offset. If includeRightBound is set, also finds nodes that end at the given offset.Nothing published for this version
* provide ems modules
added the visit.onComment API, reported when comments are allowed.
visit.onComment API, reported when comments are allowed.
ParseErrorCode.InvalidCommentToken enum value, reported when comments are disallowed.added the format API: computes edits to format a JSON document.
format API: computes edits to format a JSON document.
modify API: computes edits to insert, remove or replace a property or value in a JSON document.allyEdits API: applies edits to a documentremove nls dependency (remove getParseErrorMessage)
getParseErrorMessage)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.