JavaScript JSON parse() Method

❮ JavaScript JSON Object


Parse a string (written in JSON format) and return a JavaScript object:

var obj = JSON.parse('{"firstName":"John", "lastName":"Doe"}');
Try it Yourself »

More "Try it Yourself" examples below.

Definition and Usage

The JSON.parse() method parses a string and returns a JavaScript object.

The string has to be written in JSON format.

The JSON.parse() method can optionally transform the result with a function.

Browser Support

The numbers in the table specify the first browser version that fully supports the method.

parse() 4.0 8.0 3.5 4.0 11.5


JSON.parse(string, function)

Parameter Values

Parameter Description
string Required. A string written in JSON format
reviver function Optional. A function used to transform the result. The function is called for each item. Any nested objects are transformed before the parent.
  • If the function returns a valid value, the item value is replaced with the transformed value
  • If the function returns null or undefined, the item is deleted

Technical Details

Return Value: A JSON Object, or Array
JavaScript Version: ECMAScript 1

More Examples


How to use the reviver function:

/*replace the value of "city" to upper case:*/
var text = '{ "name":"John", "age":"39", "city":"New York"}';
var obj = JSON.parse(text, function (key, value) {
    if (key == "city") {
        return value.toUpperCase();
    } else {
        return value;

document.getElementById("demo").innerHTML = + ", " +;
Try it Yourself »


Parsing JSON received from the server:

var xmlhttp = new XMLHttpRequest();
xmlhttp.onreadystatechange = function() {
    if (this.readyState == 4 && this.status == 200) {
        var myObj = JSON.parse(this.responseText);
        document.getElementById("demo").innerHTML =;
};"GET", "json_demo.txt", true);
Try it Yourself »

Take a look at json_demo.txt

❮ JavaScript JSON Object