# relaxed-json
> Relaxed JSON is strict superset JSON, relaxing strictness of valilla JSON
Latest version **1.0.3** (published 2019-03-04) · BSD-3-Clause license · 0 weekly downloads
## Install
```sh
npm install relaxed-json
pnpm add relaxed-json
yarn add relaxed-json
bun add relaxed-json
```
Provides the command `rjson`.
## Health
**Score 23/100 (F)** — status: abandoned.
Positive: has types package; no vulnerabilities; high quality score.
Warnings: low downloads; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 1.0.3 |
| Published | 2019-03-04 |
| First published | 2013-11-02 |
| Weekly downloads | 0 |
| License | BSD-3-Clause |
| TypeScript types | separate (@types/relaxed-json) |
| Module format | CommonJS |
| Node | >= 0.10.0 |
| Dependencies | 2 |
| Unpacked size | 89.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 90 |
| Author | Oleg Grenrus |
| Maintainers | phadej |
| Keywords | json, comments, comment, config |
## Links
- npm: https://www.npmjs.com/package/relaxed-json
- Repository: https://github.com/phadej/relaxed-json
- Issues: https://github.com/phadej/relaxed-json/issues
- npm.io page: https://npm.io/package/relaxed-json
## Dependencies (2)
- [chalk](https://npm.io/package/chalk.md) ^2.4.2
- [commander](https://npm.io/package/commander.md) ^2.6.0
## Alternatives
- [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads
- [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads
- [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads
- [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads
- [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads
## Recent versions
- 1.0.3 (latest) — 2019-03-04
- 1.0.2 — 2019-03-04
- 1.0.1 — 2017-03-08
- 1.0.0 — 2015-07-13
- 0.2.9 — 2015-02-25
- 0.2.8 — 2014-10-26
- 0.2.7 — 2014-08-14
- 0.2.6 — 2014-06-30
- 0.2.4 — 2014-02-11
- 0.2.3 — 2014-02-10
- 0.2.2 — 2013-11-09
- 0.2.1 — 2013-11-09
- 0.2.0 — 2013-11-04
- 0.1.1 — 2013-11-02
- 0.1.0 — 2013-11-02
## README
# Relaxed JSON
[](http://travis-ci.org/phadej/relaxed-json)
[](http://badge.fury.io/js/relaxed-json)
[](https://david-dm.org/phadej/relaxed-json)
[](https://david-dm.org/phadej/relaxed-json#info=devDependencies)
[](https://codeclimate.com/github/phadej/relaxed-json)
Are you frustrated that you cannot add comments into your configuration JSON
Relaxed JSON is a simple solution.
Small JavaScript library with only one exposed function `RJSON.transform(text : string) : string`
(and few convenient helpers).
[Relaxed JSON](http://oleg.fi/relaxed-json) (modified BSD license) is a strict superset of JSON,
relaxing strictness of vanilla JSON.
Valid, vanilla JSON will not be changed by `RJSON.transform`. But there are few additional
features helping writing JSON by hand.
* Comments are stripped : `// foo` and `/* bar */` → ` `.
Comments are converted into whitespace, so your formatting is preserved.
* Trailing comma is allowed : `[1, 2, 3, ]` → `[1, 2, 3]`. Works also in objects `{ "foo": "bar", }` → `{ "foo": "bar" }`.
* Identifiers are transformed into strings : `{ foo: bar }` → `{ "foo": "bar" }`.
* Single quoted strings are allowed : `'say "Hello"'` → `"say \"Hello\""`.
* More different characters is supported in identifiers: `foo-bar` → `"foo-bar"`.
## API
- `RJSON.transform(text : string) : string`.
Transforms Relaxed JSON text into JSON text. Doesn't verify (parse) the JSON, i.e result JSON might be invalid as well
- `RJSON.parse(text : string, reviver : function | opts : obj) : obj`.
Parse the RJSON text, virtually `JSON.parse(JSON.transform(text), reviver)`.
You could pass a reviver function or an options object as the second argument. Supported options:
- `reviver`: you could still pass a reviver
- `relaxed`: use relaxed version of JSON (default: true)
- `warnings`: use relaxed JSON own parser, supports better error messages (default: false)
- `tolerant`: wait until the end to throw errors
- `duplicate`: fail if there are duplicate keys in objects
## Executable
There is `rjson` executable†
```sh
$ sudo npm install -g relaxed-json
$ rjson relaxed-json.js
Error on line 27: Unexpected character: (
(function () {
% rjson package.json
{
"name": "relaxed-json",
"description": "Relaxed JSON is strict superset JSON, relaxing strictness of valilla JSON",
```
†`rjson` is similar to `python -mjson.tool`.
## Changelog
- 1.0.1 — 2017-03-08 — Meteor compatibility
- [#9](https://github.com/phadej/relaxed-json/issues/9)
[#14](https://github.com/phadej/relaxed-json/pull/14)
[#15](https://github.com/phadej/relaxed-json/pull/15)
- 1.0.0 — 2015-07-13 — Stable release
- Forward slashes bug fixed
- 0.2.9 Dependencies bump
- 0.2.8 Dev dependencies update
- 0.2.7 `rjson` executable
- also depedencies update
- jscs style check
- 0.2.6 Dependencies update
- 0.2.5 Use `make`
- 0.2.4 Maintenance release
- 0.2.3 Bugfixes
- `$` is valid identifier character
- single line comments may end with `CR` and `CRLF` also
- 0.2.2 Bugfix
- 0.2.1 Code reogranization
- More though into toleration, handles valid json without colons and commas
- trailing comma stripping is more strict
- 0.2.0 Shiny new features
- overloaded `rjson.parse`
- tolerating parser support
- duplicate key warning
- test suite (!)
- 0.1.1 RJSON.parse
- 0.1.0 Initial release
## Related projects
- [strip-json-comments](https://www.npmjs.org/package/strip-json-comments)
For truly human writable configuration consider using [YAML](http://yaml.org/).
- [js-yaml](https://www.npmjs.com/package/js-yaml)
---
_Source: https://npm.io/package/relaxed-json · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._