JavaScript JSON : Object

Contains methods for encoding and decoding JSON strings.

JSON Methods

parse 2 variants

parse(str : String) : Object

Parses the specified string of JSON and converts it to an Object.

Example:

var x = JSON.parse('{"foo": 1, "bar": 2}');
console.log(x.foo);
console.log(x.bar);

Run

Results:

Spec

parse(str : String, reviver : Function) : Object

reviver(key : String, value : String) : Object

Parses the specified string of JSON and converts it to an Object. If reviver is specified, it will be called for each parsed key/value pair and the function's return value is used in place of the value.

Example:

var reviver = function(key, value) {
  if (key === 'foo') {
    return value * 10;
  }
  return value;
};
var x = JSON.parse('{"foo": 1, "bar": 2}', reviver);
console.log(x.foo);
console.log(x.bar);

Run

Results:

Spec

stringify 3 variants

stringify(value : Object) : String

Converts value to a JSON string. If value has a toJSON() method on it, the return value of that method will be used.

Example:

var x = { foo: 1, bar: 2 };
console.log(JSON.stringify(x));

x.toJSON = function() {
  return { baz: 3 };
};
console.log(JSON.stringify(x));

Run

Results:

Spec

stringify(value : Object, replacer : Function, [indent : String]) : String

replacer(key : String, value : Object) : String

Converts value to a JSON string. The replacer function is called for each key/value pair and the return value is used as the value in the final string. If indent is specified, each key/value pair will be on a new line with the indent string before the key.

Example:

var x = { foo: 1, bar: 2 };
var replacer = function(key, value) {
  if (key === 'foo') return value * 10;
  return value;
}
console.log(JSON.stringify(x, replacer, ' '));

Run

Results:

Spec

stringify(value : Object, keyNames : Array, [indent : String]) : String

Converts value to a JSON string. Only key/value pairs where the key is in keyNames will be in the JSON string. If indent is specified, each key/value pair will be on a new line with the indent string before the key.

Example:

var x = { foo: 1, bar: 2 };
console.log(JSON.stringify(x, ['foo']));

Run

Results:

Spec

home feedback