Skip to content

Latest commit

 

History

History

is-json

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

isJSON

Test if a value is a parseable JSON string.

Usage

var isJSON = require( '@stdlib/utils/is-json' );

isJSON( value )

Tests if a value is a parseable JSON string.

var value = '{"a":5}';

var bool = isJSON( value );
// returns true

Notes

  • validates that the input value is a string literal. For all other inputs, the method returns false.
  • validates that a string begins with either [ or { and ends with a corresponding ] or }, respectively. Hence, the method will return false for the following strings, despite JSON.parse accepting their input: - '<number>'; e.g., '5' - '<boolean>'; e.g., 'true' - 'null'
  • uses JSON.parse inside a try/catch. Hence, this method cannot be optimized by the compiler during runtime. Nevertheless, using this function is better than embedding a try/catch within a larger function which could be optimized in the absence of a try/catch.

Examples

var isJSON = require( '@stdlib/utils/is-json' );

console.log( isJSON( '{"a":5}' ) );
// returns true

console.log( isJSON( '{a":5}' ) );
// returns false