JSON对象

JSON格式

每个JSON对象就是一个值，可能是一个数组或对象，也可能是一个原始类型的值。总之，只能是一个值，不能是两个或更多的值。
JSON对值的类型和格式有严格的规定。

复合类型的值只能是数组或对象，不能是函数、正则表达式对象、日期对象。
原始类型的值只有四种字符串：字符串、数值（必须以十进制表示）、布尔值和null（不能使用NaN，Infinity，-Infinity和undefined）。
字符串必须使用双引号表示，不能使用单引号。
对象的键名必须放在双引号里面。
数组或对象最后一个成员的后面，不能加逗号。
以下都是合法的JSON

["one", "two", "three"]
{ "one": 1, "two": 2, "three": 3 }

JSON对象

JSON对象是JavaScript的原生对象，用来处理JSON格式数据。它有两个静态方法：JSON.stringify()和JSON.parse()。

JSON.stringify()

基本用法

JSON.stringify方法用于将一个值转为JSON字符串。该字符串符合JSON格式，可以被JSON.parse方法还原。
注意，原始类型的字符串，转换结果回带双引号。

JSON.stringify("foo") === "foo" // false
JSON.stringify("foo") === ""foo"" // true

如果对象的属性是undefined、函数或XML对象，该属性会被JSON.stringify过滤。

var obj = {
    a: undefined,
    b: function () {}
};

JSON.stringify(obj) // "{}"

如果数组的成员是undefined、函数或者XML对象，则这些值被转成null。
正则对象会被转成空对象。

JSON.stringify(/foo/) // "{}"

JSON.stringify方法会忽略对象的不可遍历的属性。

第二个参数

JSON.stringify还可以接受一个数组，作为第二个参数，指定需要转成字符串的属性。

var obj = {
    "property1": "value1",
    "property2": "value2",
    "property3": "value3"
};

var selectedProperties = ["property1", "property2"];

JSON.stringify(obj, selectedProperties);

// "{"property1": "value1", "property2": "value2"}"

这个类似白名单的数组，只对对象的属性有效，对数组无效。
第二个参数还可以是一个函数，用来更改JSON.stringify的返回值。

function f(key, value) {
    if (typeof value === "number") {
        value = 2 * value;
    }
    return value;
}
JSON.stringify({ a: 1, b: 2 }); // '{ "a": 2, "b": 4 }'

注意，这个处理函数是递归处理所有的键。

var o = { a: { b:1 } };

function f(key, value) {
    console.log("[" + key + "]:" + value);
}

JSON.stringify(o, f);

// []:[object Object]
// [a]:[object Object]
// [b]:1
// '{"a":{"b":1}}'

上面代码中，对象o一共会被函数f函数处理三次，最后那行是JSON.stringify的输出。第一次键名为空，键值是整个对象o；第二次键名为a，键值是{b: 1}；第三次键名为b，键值为1。
递归处理中，每一次处理的对象都是前一次返回的值。

var o = {a: 1};
function f(key, value) {
    if (typeof value === "object") {
        return {b: 2};
    }
    return value * 2;
}

JSON.stringify(o, f);

// '{"b": 4}'

如果处理函数返回undefined或没有返回值，该属性会被忽略。

function f(key, value) {
    if (typeof(value) === "string") {
        return undefined;
    }
    return value;
}

JSON.stringify({ a: "abc", b: 123}, f);
// '{"b": 123}'

第三个参数

JSON.stringify还可以接受第三个参数，用于增加返回的JSON字符串的可读性。如果是数字，表示每个属性前面添加空格（最多不超过10个）；如果是字符串（不超过10个字符），则该字符串会添加在每行前面。

JSON.stringify({ p1: 1, p2: 2}, null, 2);

/*
"{
  "p1": 1,
  "p2": 2
}"
*/

JSON.stringify({ p1: 1, p2: 2}, null, "|-");
/*
"{
|-"p1": 1,
|-"p2": 2
}"
*/

参数对象的toJSON方法

如果参数对象有自定义的toJSON方法，那么JSON.stringify会使用这个方法的返回值作为参数，而忽略原对象的其他属性。
下面是一个普通对象：

var user = {
    firstName = "三"，
    lastName = "张",
    
    get fullName() {
        return this.lastName + this.firstName;
    }
};

JSON.stringify(user); // '{"firstName": "三", "lastName": "张", "fullName": "张三"}'

现在为这个对象加上toJSON方法。
var user = {
firstName = "三",
lastName = "张",

get fullName() {
    return this.firstName + this.lastName;
}

toJSON: function () {
    return {
        name: this.lastName + this.firstName
    };
}

};

JSON.stringify(user)
// '{"name": "张三"}'

<font color=red>Date</font>对象就有一个自己的<font color=red>toJSON</font>方法。
<font color=red>toJSON</font>方法的一个应用是，将正则对象自动转为字符串。因为<font color=red>JSON.stringify</font>默认不能转换正则对象，但是设置了<font color=red>toJSON</font>方法以后，就可以转换正则对象了。

var obj = {
reg: /foo/
};
JSON.stringify(obj) // '{"reg":{}}'

RegExp.prototype.toJSON = RegExp.protptype.toString;
JSON.stringify(/foo/) // '"/foo/"'

## JSON.parse()
<font color=red>JSON.parse</font>方法用于将JSON字符转换成对应的值。

JSON.parse("{}") // {}
JSON.parse("true") // true
JSON.parse('"foo"') // "foo"
JSON.parse("null") // null

var o = JSON.parse('{"name": "张三"}');
o.name // 张三

如果传入的字符串不是有效的JSON格式，<font color=red>JSON.parse</font>方法将报错。

JSON.parse("'String'") // illegal single quotes
// SyntaxError: Unexpected token ILLEGAL

上面代码中，双引号字符串中是一个单引号字符串，因为单引号字符串不符合JSON格式，所以报错。
为了处理解析错误，可以将<font color=red>JSON.parse</font>方法放在<font color=red>try...catch</font>代码块中。

try {
JSON.parse("'String'")'
} catch (e) {
console.log("parsing error");
}

<font color=red>JSON.parse</font>方法可以接受一个处理函数，作为第二个参数，用法与<font color=red>JSON.strinngify</font>方法类似。

function f(key, value) {
if (key === "a") {
return value + 10;
}
return value;
}

JSON.parse('{"a": 1, "b": 2}', f); // {a: 11, b: 2}