Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ehmicky/is-json-value
Check if a value is valid JSON.
https://github.com/ehmicky/is-json-value
bigint circular cycle enumerable exception-handling exceptions getters javascript json library nodejs parsing serialization symbols tojson types typescript valid validate validation
Last synced: 18 days ago
JSON representation
Check if a value is valid JSON.
- Host: GitHub
- URL: https://github.com/ehmicky/is-json-value
- Owner: ehmicky
- License: mit
- Created: 2022-07-30T18:47:12.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-14T16:52:53.000Z (2 months ago)
- Last Synced: 2024-10-11T10:17:07.805Z (about 1 month ago)
- Topics: bigint, circular, cycle, enumerable, exception-handling, exceptions, getters, javascript, json, library, nodejs, parsing, serialization, symbols, tojson, types, typescript, valid, validate, validation
- Language: JavaScript
- Homepage:
- Size: 6.36 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/is-json-value)
[](https://unpkg.com/is-json-value?module)
[](/src/main.d.ts)
[](https://codecov.io/gh/ehmicky/is-json-value)
[](https://bundlephobia.com/package/is-json-value)
[](https://fosstodon.org/@ehmicky)
[](https://medium.com/@ehmicky)
Check if a value is valid JSON.
# Hire me
Please
[reach out](https://www.linkedin.com/feed/update/urn:li:activity:7117265228068716545/)
if you're looking for a Node.js API or CLI engineer (11 years of experience).
Most recently I have been [Netlify Build](https://github.com/netlify/build)'s
and [Netlify Plugins](https://www.netlify.com/products/build/plugins/)'
technical lead for 2.5 years. I am available for full-time remote positions.
# Features
- Detects [many types](#warnings) of invalid values with JSON
- Returns [warning messages](#message) to throw or log
- Returns invalid properties' [path](#path) and [value](#value)
# Example
```js
import isJsonValue from 'is-json-value'
const input = { one: true, two: { three: Symbol() } }
input.self = input
// Throws due to cycle with 'self'.
// Also, 'two.three' would be omitted since it has an invalid JSON type.
JSON.stringify(input)
const warnings = isJsonValue(input)
const isValidJson = warnings.length === 0 // false
console.log(warnings)
// [
// {
// message: 'Property "two.three" must not be a symbol.',
// path: ['two', 'three'],
// value: Symbol(),
// reason: 'ignoredSymbolValue'
// },
// {
// message: 'Property "self" must not be a circular value.',
// path: ['self'],
// value: { one: true, two: [Object], self: [Circular *1] },
// reason: 'unsafeCycle'
// }
// ]
if (!isValidJson) {
// Error: Property "two.three" must not be a symbol.
throw new Error(warnings[0].message)
}
```
# Install
```bash
npm install is-json-value
```
This package works in both Node.js >=18.18.0 and
[browsers](https://raw.githubusercontent.com/ehmicky/dev-tasks/main/src/browserslist).
This is an ES module. It must be loaded using
[an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c),
not `require()`. If TypeScript is used, it must be configured to
[output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html),
not CommonJS.
# API
## isJsonValue(input)
`input` `any`\
_Return value_: [`Warning[]`](#warning)
Returns an array of [warnings](#warning). If `input` is valid to serialize as
JSON, that array is empty.
### Warning
Each warning is an object indicating that a specific property is invalid to
serialize as JSON. The same property might have multiple warnings.
#### message
_Type_: `string`
Warning message, like `'Property "example" must not be a symbol.'`
#### path
_Type_: `Array`
Path to the invalid property. Empty array if this is the top-level value.
#### value
_Type_: `unknown`
Value of the invalid property.
#### reason
_Type_: `string`
Reason for the warning among:
- [Invalid type](#invalid-types): [`"ignoredFunction"`](#functions),
[`"ignoredUndefined"`](#undefined), [`"ignoredSymbolValue"`](#symbol-values),
[`"ignoredSymbolKey"`](#symbol-keys),
[`"unstableInfinite"`](#nan-and-infinity), [`"unresolvedClass"`](#classes),
[`"ignoredNotEnumerable"`](#non-enumerable-keys),
[`"ignoredArrayProperty"`](#array-properties)
- [Throws an exception](#exceptions): [`"unsafeCycle"`](#cycles),
[`"unsafeBigInt"`](#bigint), [`"unsafeSize"`](#big-properties),
[`"unsafeException"`](#infinite-recursion),
[`"unsafeToJSON"`](#exceptions-in-tojson),
[`"unsafeGetter"`](#exceptions-in-getters)
# Warnings
This is the list of possible warnings.
## Invalid types
JSON only supports booleans, numbers, strings, arrays, objects and `null`. Any
other type is omitted or transformed by `JSON.stringify()`.
### Functions
```js
const invalidJson = { prop: () => {} }
JSON.stringify(invalidJson) // '{}'
```
### Undefined
```js
const invalidJson = { prop: undefined }
JSON.stringify(invalidJson) // '{}'
```
### Symbol values
```js
const invalidJson = { prop: Symbol() }
JSON.stringify(invalidJson) // '{}'
```
### Symbol keys
```js
const invalidJson = { [Symbol()]: true }
JSON.stringify(invalidJson) // '{}'
```
### NaN and Infinity
```js
const invalidJson = { one: Number.NaN, two: Number.POSITIVE_INFINITY }
JSON.stringify(invalidJson) // '{"one":null,"two":null}'
```
### Classes
```js
const invalidJson = { prop: new Set([]) }
JSON.stringify(invalidJson) // '{"prop":{}}'
```
### Non-enumerable keys
```js
const invalidJson = {}
Object.defineProperty(invalidJson, 'prop', { value: true, enumerable: false })
JSON.stringify(invalidJson) // '{}'
```
### Array properties
```js
const invalidJson = []
invalidJson.prop = true
JSON.stringify(invalidJson) // '[]'
```
## Exceptions
`JSON.stringify()` can throw on specific properties.
### Cycles
```js
const invalidJson = { prop: true }
invalidJson.self = invalidJson
JSON.stringify(invalidJson) // Throws: Converting circular structure to JSON
```
### BigInt
```js
const invalidJson = { prop: 0n }
JSON.stringify(invalidJson) // Throws: Do not know how to serialize a BigInt
```
### Big properties
```js
const invalidJson = { prop: '\n'.repeat(5e8) }
JSON.stringify(invalidJson) // Throws: Invalid string length
```
### Infinite recursion
```js
const invalidJson = { toJSON: () => ({ invalidJson }) }
JSON.stringify(invalidJson) // Throws: Maximum call stack size exceeded
```
### Exceptions in `toJSON()`
```js
const invalidJson = {
prop: {
toJSON: () => {
throw new Error('example')
},
},
}
JSON.stringify(invalidJson) // Throws: example
```
### Exceptions in getters
```js
const invalidJson = {
get prop() {
throw new Error('example')
},
}
JSON.stringify(invalidJson) // Throws: example
```
### Exceptions in proxies
```js
const invalidJson = new Proxy(
{ prop: true },
{
get: () => {
throw new Error('example')
},
},
)
JSON.stringify(invalidJson) // Throws: example
```
# Related projects
- [`safe-json-value`](https://github.com/ehmicky/safe-json-value): ⛑️ JSON
serialization should never fail
- [`truncate-json`](https://github.com/ehmicky/truncate-json): Truncate a JSON
string
- [`guess-json-indent`](https://github.com/ehmicky/guess-json-indent): Guess the
indentation of a JSON string
# Support
For any question, _don't hesitate_ to [submit an issue on GitHub](../../issues).
Everyone is welcome regardless of personal background. We enforce a
[Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and
inclusive environment.
# Contributing
This project was made with ❤️. The simplest way to give back is by starring and
sharing it online.
If the documentation is unclear or has a typo, please click on the page's `Edit`
button (pencil icon) and suggest a correction.
If you would like to help us fix a bug or add a new feature, please check our
[guidelines](CONTRIBUTING.md). Pull requests are welcome!