Gadgets.json (v0.8)

From OpenSocial

This page is out of date. A more current version of this page is available at Gadgets.json (v0.9).

gadgets.json

Provides operations for translating objects to and from JSON.

Methods

gadgets.json.stringify

gadgets.json.stringify(v)

Converts a JavaScript value to a JSON string.

Parameters

Object v - The object to convert

Returns

String - The JSON equivalent

gadgets.json.parse

gadgets.json.parse(text)

Parses a JSON string, producing a JavaScript value.

Parameters

String text - The string to transform into an object — usually the result of a previous stringify call

Returns

Object - The object parsed from the passed in text; false if an error occurred

Examples

var original = { "string" : "value",
                 "number" : 42,
                 "array"  : [1,2,3] };
 
var json = gadgets.json.stringify(original);
// json == '{"string":"value","number":42,"array":[1,2,3]}'
 
var jsObject = gadgets.json.parse(json);
// jsObject["string"] == "value"
// jsObject["number"] == 42
// jsObject["array"] == 1,2,3