327

I have a simple AJAX call, and the server will return either a JSON string with useful data or an error message string produced by the PHP function mysql_error(). How can I test whether this data is a JSON string or the error message.

It would be nice to use a function called isJSON just like you can use the function instanceof to test if something is an Array.

This is what I want:

if (isJSON(data)){
    //do some data stuff
}else{
    //report the error
    alert(data);
}
1

21 Answers 21

488

Use JSON.parse

function isJson(str) {
    try {
        JSON.parse(str);
    } catch (e) {
        return false;
    }
    return true;
}
15
  • 113
    Exception handling shouldn't be used to do something expected. Commented Aug 31, 2015 at 5:57
  • 119
    JSON.parse(1234) OR JSON.parse(0) OR JSON.parse(false) OR JSON.parse(null) all will not raise Exception and will return true !!. do not use this answer Commented Sep 12, 2015 at 23:26
  • 33
    @Zalaboza 1234, 0, false, and null are all valid JSON values. If you want a predicate that tests if the JSON represents an object you'll need to do a little more. Commented Nov 18, 2015 at 23:15
  • 32
    JSON.parse does a lot of computation to parse the string, and give you the json object if it succeeds, yet you're discarding the result which some users might want to use. That does not seem to be good. I'd instead return {value: JSON.parse(str), valid: true}; and in the catch block return {value: str, valid: false};.. and I'd change the function name to tryParse(). Commented Jun 8, 2016 at 8:24
  • 14
    @luisZavaleta then what do you suggest as a method
    – PirateApp
    Commented Dec 26, 2017 at 7:30
155

Using JSON.parse() has some drawbacks:

  1. JSON.parse(1234) or
  2. JSON.parse(0) or
  3. JSON.parse(false) or
  4. JSON.parse(null)

all will return true.

function isJson(str) {
  try {
    JSON.parse(str);
  } catch (e) {
    return false;
  }  
  return true;
}

function testIsJson(value, expected) {
  console.log(`Expected: ${expected}, Actual: ${isJson(value)}`); 
}

// All of the following codes are expected to return false.
// But actually returns true.
testIsJson(1234, false);
testIsJson(0, false);
testIsJson(false, false);
testIsJson(null, false);

Code that handles false positives

So I rewrote code in this way:

function isJson(item) {
  let value = typeof item !== "string" ? JSON.stringify(item) : item;    
  try {
    value = JSON.parse(value);
  } catch (e) {
    return false;
  }
    
  return typeof value === "object" && value !== null;
}

Testing result:

function isJson(item) {
  let value = typeof item !== "string" ? JSON.stringify(item) : item;
  try {
    value = JSON.parse(value);
  } catch (e) {
    return false;
  }

  return typeof value === "object" && value !== null;
}

function testIsJson(value, expected) {
  console.log(`Expected: ${expected}, Actual: ${isJson(value)}`);
}

const validJson = { "foo": "bar" };
const notValidJson = '{ "foo": "bar" } invalid';

// expected: true
testIsJson(validJson, true);

// expected: false
testIsJson(1234, false);
testIsJson(0, false);
testIsJson(notValidJson, false);
testIsJson(false, false);
testIsJson(null, false);

6
  • 10
    Nice work! Your last if statement could be simplified to a simple return statement such as: return (typeof suspect === "object" && suspect !== null);
    – Nebulosar
    Commented Sep 10, 2018 at 7:35
  • If you test a .srt file (subtitle file) with this function, it will give true. Commented May 4, 2021 at 3:36
  • 1
    1234, 0, false, and null are all valid JSON and should return true. They aren't false positives. Commented Aug 3, 2023 at 20:04
  • 1
    @rink.attendant.6 They may be valid JSON but in common usage of JSON they would be invalid. I've never written a program expecting JSON "{"random":"random"} that also expected arbitrary numbers. In common usage I think most people would consider these false positives, or maybe I'm wrong. I'd love to see a program looking for JSON that also looks for these and uses them, if only to learn something new.
    – Andrew
    Commented Oct 27, 2023 at 9:56
  • 1. Returns false for isJson("null"). 2. OP asked for a string input. 3. You could had just added a guard clause returning false if typeof != string, if you really want to enforce JSON in string data type Commented Mar 15 at 1:18
101

Let's recap this (for 2019+).

Argument: Values such as true, false, null are valid JSON (?)

FACT: These primitive values are JSON-parsable but they are not well-formed JSON structures. JSON specification indicates JSON is built on on two structures: A collection of name/value pair (object) or an ordered list of values (array).

Argument: Exception handling shouldn't be used to do something expected.
(This is a comment that has 25+ upvotes!)

FACT: No! It's definitely legal to use try/catch, especially in a case like this. Otherwise, you'd need to do lots of string analysis stuff such as tokenizing / regex operations; which would have terrible performance.

hasJsonStructure()

This is useful if your goal is to check if some data/text has proper JSON interchange format.

function hasJsonStructure(str) {
    if (typeof str !== 'string') return false;
    try {
        const result = JSON.parse(str);
        const type = Object.prototype.toString.call(result);
        return type === '[object Object]' 
            || type === '[object Array]';
    } catch (err) {
        return false;
    }
}

Usage:

hasJsonStructure('true')             // —» false
hasJsonStructure('{"x":true}')       // —» true
hasJsonStructure('[1, false, null]') // —» true

safeJsonParse()

And this is useful if you want to be careful when parsing some data to a JavaScript value.

function safeJsonParse(str) {
    try {
        return [null, JSON.parse(str)];
    } catch (err) {
        return [err];
    }
}

Usage:

const [err, result] = safeJsonParse('[Invalid JSON}');
if (err) {
    console.log('Failed to parse JSON: ' + err.message);
} else {
    console.log(result);
}
8
  • 1
    You link to the JSON Spec says the following: "A JSON text is a sequence of tokens formed from Unicode code points that conforms to the JSON value grammar." and "A JSON value can be an object, array, number, string, true, false, or null." - How did you arrive at the conclusion that a JSON can only be object or array at root level? I can't see this in the spec, nor anything regarding "well-formed JSON structures" Commented Apr 16, 2019 at 12:11
  • Read the second paragraph that starts with "JSON is built on two structures..." @ json.org or 4th and 5th paragraphs of ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf Commented Apr 19, 2019 at 0:38
  • 1
    json.org is informative only. Reading the spec you linked to doesn't support your suggestion. The spec mentions RFC 8259 as the latest RFC. Take a look at examples of valid JSON texs containing only values tools.ietf.org/html/rfc8259#section-13 - RFC 8259 is designed to resolve possible ambiguities and confusions, just like this. Commented Apr 19, 2019 at 18:25
  • 2
    Read the answer again. I'm saying values such as primitives (i.e. text values in the RFC examples) are not JSON "structure"s. There are no ambiguities. You CAN parse them as JSON, it's valid to do so. But they are not structured data. JSON is mainly invented as an interchange format » which is used for structured data » which can be an object or array. Commented Apr 22, 2019 at 23:29
  • 3
    OK, so I think we agree. Primatives are valid JSON according to the specification, but aren't "structures". That's fine. But, you said "Argument: Values such as true, false, null are valid JSON (?). Fact: Yes and no!" - The fact is the ARE valid JSON according to the specification. Opinions on if they are useful or not are irrelevant to that fact. Commented Apr 23, 2019 at 8:10
26

If the server is responding with JSON then it would have an application/json content-type, if it is responding with a plain text message then it should have a text/plain content-type. Make sure the server is responding with the correct content-type and test that.

0
18

When using jQuery $.ajax() the response will have the responseJSON property if the response was JSON, this can be tested like this:

if (xhr.hasOwnProperty('responseJSON')) {}
2
  • 3
    This is I suspect is really the answer that most people are looking for, probably even the OP
    – Kirby
    Commented Nov 4, 2015 at 23:05
  • 1
    This is much more elegant than using the try catch block Commented Feb 15, 2018 at 15:56
9
var parsedData;

try {
    parsedData = JSON.parse(data)
} catch (e) {
    // is not a valid JSON string
}

However, I will suggest to you that your http call / service should return always a data in the same format. So if you have an error, than you should have a JSON object that wrap this error:

{"error" : { "code" : 123, "message" : "Foo not supported" } } 

And maybe use as well as HTTP status a 5xx code.

9

I use just 2 lines to perform that:

var isValidJSON = true;
try { JSON.parse(jsonString) } catch { isValidJSON = false }

That's all!

But keep in mind there are 2 traps:
1. JSON.parse(null) returns null
2. Any number or string can be parsed with JSON.parse() method.
   JSON.parse("5") returns 5
   JSON.parse(5) returns 5

Let's some play on code:

// TEST 1
var data = '{ "a": 1 }'

// Avoiding 'null' trap! Null is confirmed as JSON.
var isValidJSON = data ? true : false
try { JSON.parse(data) } catch(e) { isValidJSON = false }

console.log("data isValidJSON: ", isValidJSON);
console.log("data isJSONArray: ", isValidJSON && JSON.parse(data).length ? true : false);

Console outputs:
data isValidJSON:  true
data isJSONArray:  false


// TEST 2
var data2 = '[{ "b": 2 }]'

var isValidJSON = data ? true : false
try { JSON.parse(data2) } catch(e) { isValidJSON = false }

console.log("data2 isValidJSON: ", isValidJSON);
console.log("data2 isJSONArray: ", isValidJSON && JSON.parse(data2).length ? true : false);

Console outputs:
data2 isValidJSON:  true
data2 isJSONArray:  true


// TEST 3
var data3 = '[{ 2 }]'

var isValidJSON = data ? true : false
try { JSON.parse(data3) } catch(e) { isValidJSON = false }

console.log("data3 isValidJSON: ", isValidJSON);
console.log("data3 isJSONArray: ", isValidJSON && JSON.parse(data3).length ? true : false);

Console outputs:
data3 isValidJSON:  false
data3 isJSONArray:  false


// TEST 4
var data4 = '2'

var isValidJSON = data ? true : false
try { JSON.parse(data4) } catch(e) { isValidJSON = false }

console.log("data4 isValidJSON: ", isValidJSON);
console.log("data4 isJSONArray: ", isValidJSON && JSON.parse(data4).length ? true : false);


Console outputs:
data4 isValidJSON:  true
data4 isJSONArray:  false


// TEST 5
var data5 = ''

var isValidJSON = data ? true : false
try { JSON.parse(data5) } catch(e) { isValidJSON = false }

console.log("data5 isValidJSON: ", isValidJSON);
console.log("data5 isJSONArray: ", isValidJSON && JSON.parse(data5).length ? true : false);


Console outputs:
data5 isValidJSON:  false
data5 isJSONArray:  false

// TEST 6
var data6; // undefined

var isValidJSON = data ? true : false
try { JSON.parse(data6) } catch(e) { isValidJSON = false }

console.log("data6 isValidJSON: ", isValidJSON);
console.log("data6 isJSONArray: ", isValidJSON && JSON.parse(data6).length ? true : false);

Console outputs:
data6 isValidJSON:  false
data6 isJSONArray:  false
6
  • 1
    I've created a fiddle for this answer at jsfiddle.net/fatmonk/gpn4eyav which includes the option of adding your own user test data as well. This looks like the basis of a good library function to me, but I'd like to understand more about why Test 1 is not a valid JSON array.
    – Fat Monk
    Commented Jan 4, 2017 at 10:25
  • Because an array must be specified by using [ and ]. For instance, [1, 2, 3] is a number array. ["a", "b", "c"] is a string array. And [{"a":1}, {"b":2}] is a JSON array. Your jsfiddle work seems really useful!
    – efkan
    Commented Jan 4, 2017 at 13:07
  • As simple as that?! So Test 1 is a JSON object and Test 2 is a JSON array consisting of a single JSON object element. Have I understood that correctly?
    – Fat Monk
    Commented Jan 4, 2017 at 13:11
  • The question flagged as a possible duplicate of this (stackoverflow.com/questions/3710204/…) asks about achieving this without using try/catch so I've forked my fiddle to try to achieve that goal as well. The fork is at jsfiddle.net/fatmonk/827jsuvr and works with all tests above except for Test 3 which errors at the JSON.parse. Can anyone advise how to avoid that error without using try?
    – Fat Monk
    Commented Jan 4, 2017 at 17:04
  • Your jsfiddle application throws an error because of Test 3 doesn't have a valid JSON expression. So a try-catch must be used to catch that error and to evaluate any error as the expression is not JSON when parsing like Test 3 above: try { JSON.parse(data3) } catch(e) { isValidJSON = false }
    – efkan
    Commented Jan 4, 2017 at 17:22
7

I like best answer but if it is an empty string it returns true. So here's a fix:

function isJSON(MyTestStr){
    try {
        var MyJSON = JSON.stringify(MyTestStr);
        var json = JSON.parse(MyJSON);
        if(typeof(MyTestStr) == 'string')
            if(MyTestStr.length == 0)
                return false;
    }
    catch(e){
        return false;
    }
    return true;
}
1
  • 1
    var json is not used? or just to catch the error ?
    – stackdave
    Commented Jul 21, 2017 at 11:48
5

There are probably tests you can do, for instance if you know that the JSON returned is always going to be surrounded by { and } then you could test for those characters, or some other hacky method. Or you could use the json.org JS library to try and parse it and test if it succeeds.

I would however suggest a different approach. Your PHP script currently returns JSON if the call is successful, but something else if it is not. Why not always return JSON?

E.g.

Successful call:

{ "status": "success", "data": [ <your data here> ] }

Erroneous call:

{ "status": "error", "error": "Database not found" }

This would make writing your client side JS much easier - all you have to do is check the "status" member and the act accordingly.

5

Well... It depends the way you are receiving your data. I think the server is responding with a JSON formated string (using json_encode() in PHP,e.g.). If you're using JQuery post and set response data to be a JSON format and it is a malformed JSON, this will produce an error:

$.ajax({
  type: 'POST',
  url: 'test2.php',
  data: "data",
  success: function (response){

        //Supposing x is a JSON property...
        alert(response.x);

  },
  dataType: 'json',
  //Invalid JSON
  error: function (){ alert("error!"); }
});

But, if you're using the type response as text, you need use $.parseJSON. According jquery site: "Passing in a malformed JSON string may result in an exception being thrown". Thus your code will be:

$.ajax({
  type: 'POST',
  url: 'test2.php',
  data: "data",
  success: function (response){

        try {
            parsedData = JSON.parse(response);
        } catch (e) {
            // is not a valid JSON string
        }

  },
  dataType: 'text',
});
2
  • unless, of course you are trying to parse the error text in the error function in the above example and not sure if it is JSON...
    – Kirby
    Commented Nov 4, 2015 at 23:01
  • Great answer, although if response is empty, it will go to success :'( Commented Jul 24, 2016 at 15:09
5

All json strings start with '{' or '[' and end with the corresponding '}' or ']', so just check for that.

Here's how Angular.js does it:

var JSON_START = /^\[|^\{(?!\{)/;
var JSON_ENDS = {
  '[': /]$/,
  '{': /}$/
};

function isJsonLike(str) {
    var jsonStart = str.match(JSON_START);
    return jsonStart && JSON_ENDS[jsonStart[0]].test(str);
}

https://github.com/angular/angular.js/blob/v1.6.x/src/ng/http.js

7
  • @DukeDougal care to clarify? Sometimes people start their json with a '[' but that's not terribly common. Commented Jun 8, 2016 at 23:01
  • 1
    You need to parse it to work out of it is valid JSON. If it is invalid JSON then it is not JSON. The question is "how tell tell if a string is JSON or not?". By your approach, this would be JSON {fibble - and it's really not JSON. Consider also cases like the number 1 on its own - that is valid JSON. Commented Jun 9, 2016 at 2:51
  • 1
    "If it is invalid JSON then it is not JSON". The fact that you have to use the word "valid" shows that you're adding a qualification to the fact that it's more than just json. The question was simply "is it json" and my code example answers that question perfectly without assuming additional requirements. Commented Jun 9, 2016 at 21:43
  • bad idea if you are using some of template systems and you have something like { someValue } will automatically pass the validation.
    – ncubica
    Commented Sep 6, 2016 at 21:30
  • @ncubica so you're using a template for something other than json, the string only contains a placeholder that uses curly braces, and the template engine fails to replace the placeholder with the real value? Also keep in mind, like I explained to Duke already, the original question doesn't mention validation. They only wanted to know if it looked like json or not. Commented Sep 6, 2016 at 22:43
5

Here is a code with some minor modification in Bourne's answer. As JSON.parse(number) works fine without any exception so added isNaN.

function isJson(str) {
    try {
        JSON.parse(str);
    } catch (e) {
        return false;
    }
    return isNaN(str);
}
3

I think something like following method should do the job, it returns the parsed JSON (in case of valid JSON), so you don't need to call the JSON.parse again.

const tryParseJSON = (s) => {
    if (!s) return false;

    try {
        var o = JSON.parse(s);
        if (o && typeof o === "object") return o;
    }
    catch (e) { }

    return false;
};
3

You can try the following one because it also validates number, null, string but the above-marked answer is not working correctly it's just a fix of the above function:

function isJson(str) {
  try {
    const obj = JSON.parse(str);
    return obj && typeof obj === 'object' && !Array.isArray(obj);
  } catch (err) {
    return false;
  }
}
2

You could try decoding it and catching the exception (native or json2.js):

try {
  newObj = JSON.parse(myJsonString);
} catch (e) {
  console.log('Not JSON');
}

However, I would suggest making the response always be valid JSON. If you get an error back from your MySQL query, simply send back JSON with the error:

{"error":"The MySQL error string."}

And then:

if (myParsedJSON.error) {
  console.log('An error occurred: ' + myParsedJSON.error);
}
2

I used this one (kind of mix of different answers, but anyway):

const isJSON = str => {
  if (typeof str === 'string'){
    try {
      JSON.parse(str)
      return true
    } catch(e){
    }
  }
  return false
}



[null, undefined, false, true, [], {}, 
 '', 'asdf', '{}', '[]', "{\"abc\": 2}","{\"abc\": \"2\"}"]
  .map(el => {
      console.log(`[>${el}<] - ${isJSON(el)}`)
})

console.log('-----------------')

2

Warning: For methods relying on JSON.parse - Arrays and quote surrounded strings will pass too (ie. console.log(JSON.parse('[3]'), JSON.parse('"\uD800"')))

To avoid all non-object JSON primitives (boolean, null, array, number, string), I suggest using the following:

/* Validate a possible object ie. o = { "a": 2 } */
const isJSONObject = (o) => 
  !!o && (typeof o === 'object') && !Array.isArray(o) && 
  (() => { try { return Boolean(JSON.stringify(o)); } catch { return false } })()

/* Validate a possible JSON object represented as string ie. s = '{ "a": 3 }' */
function isJSONObjectString(s) {
    try {
        const o = JSON.parse(s);
        return !!o && (typeof o === 'object') && !Array.isArray(o)
    } catch {
        return false
    }
}

Code Explanation

  • !!o - Not falsy (excludes null, which registers as typeof 'object')
  • (typeof o === 'object') - Excludes boolean, number, and string
  • !Array.isArray(o) - Exclude arrays (which register as typeof 'object')
  • try ... JSON.stringify / JSON.parse - Asks JavaScript engine to determine if valid JSON

Why not use the hasJsonStructure() answer?

Relying on toString() is not a good idea. This is because different JavaScript Engines may return a different string representation. In general, methods which rely on this may fail in different environments or may be subject to fail later should the engine ever change the string result

Why is catching an exception not a hack?

It was brought up that catching an exception to determine something's validity is never the right way to go. This is generally good advice, but not always. In this case, exception catching is likely is the best route because it relies on the JavaScript engine's implementation of validating JSON data.

Relying on the JS engine offers the following advantages:

  1. More thorough and continually up-to-date as JSON spec changes
  2. Likely to run faster (as it's lower level code)

When given the opportunity to lean on the JavaScript engine, I'd suggest doing it. Particularly so in this case. Although it may feel hacky to catch an exception, you're really just handling two possible return states from an external method.

2

For me I simply did this just by 2 positive returned condition,

First Condition - Check if the both ends are "{" and "}"

Second Condition - Check if it is parsable by JSON

here how I did it

const isJsonStringified = (value) => {
  try {
    const isObject = value.slice(0, 1) === '{' && value.slice(value.length - 1) === '}';
    if (typeof value === 'string' && isObject) {
      JSON.parse(value);
    } else {
      return false;
    }
  } catch (err) {
    return false;
  }
  return true;
};

Welcome :)

0

If you don't mind lodash

npm i -S lodash

const isPlainObject = require("lodash/isPlainObject"); // cjs
// import {isPlainObject} from "lodash"; // esm
function checkIfJSON(input) {
  const inputStr = typeof input === "string" ? input : JSON.stringify(input);
  try {
    if (isPlainObject(JSON.parse(inputStr))) {
      return true;
    }
  } catch (e) {
    return false;
  }
}
0

Numbers and boolean values are accepted as valid json in JSON.parse(), just add type validations before parsing

function isJson(str) {

    if(!isNaN(str) || str.toString() == 'true' || str.toString() == 'false'){
        return false;
    }

    try {

        JSON.parse(str);

    } catch (e) {

        return false;

    }

    return true;

}
-1

In addition to previous answers, in case of you need to validate a JSON format like "{}", you can use the following code:

const validateJSON = (str) => {
  try {
    const json = JSON.parse(str);
    if (Object.prototype.toString.call(json).slice(8,-1) !== 'Object') {
      return false;
    }
  } catch (e) {
    return false;
  }
  return true;
}

Examples of usage:

validateJSON('{}')
true
validateJSON('[]')
false
validateJSON('')
false
validateJSON('2134')
false
validateJSON('{ "Id": 1, "Name": "Coke" }')
true

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.