JSON格式

JSON格式（JavaScript Object Notation的縮寫(xiě)）是一種用于數(shù)據(jù)交換的文本格式，2001年由Douglas Crockford提出，目的是取代繁瑣笨重的XML格式。

相比XML格式，JSON格式有兩個(gè)顯著的優(yōu)點(diǎn)：書(shū)寫(xiě)簡(jiǎn)單，一目了然；符合JavaScript原生語(yǔ)法，可以由解釋引擎直接處理，不用另外添加代碼。所以，JSON迅速被接受，已經(jīng)成為各大網(wǎng)站交換數(shù)據(jù)的標(biāo)準(zhǔn)格式，并被寫(xiě)入ECMAScript 5，成為標(biāo)準(zhǔn)的一部分。

簡(jiǎn)單說(shuō)，JSON格式就是一種表示一系列的“值”的方法，這些值包含在數(shù)組或?qū)ο笾?，是它們的成員。對(duì)于這一系列的“值”，有如下幾點(diǎn)格式規(guī)定：

1. 數(shù)組或?qū)ο蟮拿總€(gè)成員的值，可以是簡(jiǎn)單值，也可以是復(fù)合值。

2. 簡(jiǎn)單值分為四種：字符串、數(shù)值（必須以十進(jìn)制表示）、布爾值和null（NaN, Infinity, -Infinity和undefined都會(huì)被轉(zhuǎn)為null）。

3. 復(fù)合值分為兩種：符合JSON格式的對(duì)象和符合JSON格式的數(shù)組。

4. 數(shù)組或?qū)ο笞詈笠粋€(gè)成員的后面，不能加逗號(hào)。

5. 數(shù)組或?qū)ο笾械淖址仨毷褂秒p引號(hào)，不能使用單引號(hào)。

6. 對(duì)象的成員名稱(chēng)必須使用雙引號(hào)。

以下是合格的JSON值。

["one", "two", "three"]

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

{"names": ["張三", "李四"] }

[ { "name": "張三"}, {"name": "李四"} ]

以下是不合格的JSON值。

{ name: "張三", 'age': 32 }  // 屬性名必須使用雙引號(hào)

[32, 64, 128, 0xFFF] // 不能使用十六進(jìn)制值

{ "name": "張三", age: undefined } // 不能使用undefined

{ "name": "張三",
  "birthday": new Date('Fri, 26 Aug 2011 07:13:10 GMT'),
  "getName": function() {
      return this.name;
  }
} // 不能使用函數(shù)和日期對(duì)象

需要注意的是，空數(shù)組和空對(duì)象都是合格的JSON值，null本身也是一個(gè)合格的JSON值。

JSON對(duì)象

ES5新增了JSON對(duì)象，用來(lái)處理JSON格式數(shù)據(jù)。它有兩個(gè)方法：JSON.stringify和JSON.parse。

JSON.stringify()

JSON.stringify方法用于將一個(gè)值轉(zhuǎn)為字符串。該字符串符合JSON格式，并且可以被JSON.parse方法還原。

JSON.stringify("abc") // '"abc"'
JSON.stringify(1) // "1"
JSON.stringify(false) // "false"
JSON.stringify([]) // "[]"
JSON.stringify({}) // "{}"

JSON.stringify([1, "false", false])
// '[1,"false",false]'

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

上面代碼將各種類(lèi)型的值，轉(zhuǎn)成JSON字符串。需要注意的是，對(duì)于原始類(lèi)型的字符串，轉(zhuǎn)換結(jié)果會(huì)帶雙引號(hào)，即字符串abc會(huì)被轉(zhuǎn)成"abc"，這是因?yàn)閷?lái)還原的時(shí)候，雙引號(hào)可以讓JavaScript引擎知道，abc是一個(gè)字符串，而不是一個(gè)變量名。

如果原始對(duì)象中，有一個(gè)成員的值是undefined、函數(shù)或XML對(duì)象，這個(gè)成員會(huì)被省略。如果數(shù)組的成員是undefined、函數(shù)或XML對(duì)象，則這些值被轉(zhuǎn)成null。

JSON.stringify({
    f: function(){},
    a: [ function(){}, undefined ]
});
// "{"a":[null,null]}"

上面代碼中，原始對(duì)象的f屬性是一個(gè)函數(shù)，JSON.stringify方法返回的字符串會(huì)將這個(gè)屬性省略。而a屬性是一個(gè)數(shù)組，成員分別為函數(shù)和undefined，它們都被轉(zhuǎn)成了null。

正則對(duì)象會(huì)被轉(zhuǎn)成空對(duì)象。

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

JSON.stringify方法會(huì)忽略對(duì)象的不可遍歷屬性。

var obj = {};
Object.defineProperties(obj, {
  'foo': {
    value: 1,
    enumerable: true
  },
  'bar': {
    value: 2,
    enumerable: false
  }
});

JSON.stringify(obj); // {"foo":1}

上面代碼中，bar是obj對(duì)象的不可遍歷屬性，JSON.stringify方法會(huì)忽略這個(gè)屬性。

JSON.stringify方法還可以接受一個(gè)數(shù)組參數(shù)，指定需要轉(zhuǎn)成字符串的屬性。

JSON.stringify({ a:1, b:2 }, ['a'])// '{"a":1}'

上面代碼中，JSON.stringify方法的第二個(gè)參數(shù)指定，只轉(zhuǎn)a屬性。

JSON.stringify方法還可以接受一個(gè)函數(shù)作為參數(shù)，用來(lái)更改默認(rèn)的字符串化的行為。

function f(key, value) {
  if (typeof value === "number") {
    value = 2 * value;
  }
  return value;
}

JSON.stringify({ a:1, b:2 }, f)
// '{"a":2,"b":4}'

上面代碼中的f函數(shù)，接受兩個(gè)參數(shù)，分別是被轉(zhuǎn)化對(duì)象的鍵和值。如果一個(gè)鍵的值是數(shù)值，就將它乘以2，否則就原樣返回。

注意，這個(gè)處理函數(shù)是遞歸處理所有的鍵。

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

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

JSON.stringify(o, f)
// []:[object Object] 
// [a]:[object Object]
// [b]:1
// '{"a":{"b":1}}'

上面代碼中，對(duì)象o一共會(huì)被f函數(shù)處理三次。第一次鍵名為空，鍵值是整個(gè)對(duì)象o；第二次鍵名為a，鍵值是{b:1}；第三次鍵名為b，鍵值為1。

遞歸處理中，每一次處理的對(duì)象，都是前一次返回的值。

var o = {a: 1};

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

JSON.stringify(o,f)
// '{"b":4}'

上面代碼中，f函數(shù)修改了對(duì)象o，接著JSON.stringify方法就遞歸處理修改后的對(duì)象o。

如果處理函數(shù)返回undefined或沒(méi)有返回值，則該屬性會(huì)被忽略。

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

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

上面代碼中，a屬性經(jīng)過(guò)處理后，返回undefined，于是該屬性被忽略了。

JSON.stringify還可以接受第三個(gè)參數(shù)，用于增加返回的JSON字符串的可讀性。如果是數(shù)字，表示每個(gè)屬性前面添加的空格（最多不超過(guò)10個(gè)）；如果是字符串（不超過(guò)10個(gè)字符），則該字符串會(huì)添加在每行前面。

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

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

如果JSON.stringify方法處理的對(duì)象，包含一個(gè)toJSON方法，則它會(huì)使用這個(gè)方法得到一個(gè)值，然后再將這個(gè)值轉(zhuǎn)成字符串，而忽略其他成員。

JSON.stringify({
  toJSON: function() {
    return "Cool"
  }
})
// "Cool""

var o = {
  foo: 'foo',
  toJSON: function() {
    return 'bar';
  }
};
var json = JSON.stringify({x: o}); 
// '{"x":"bar"}'

Date對(duì)象就部署了一個(gè)自己的toJSON方法。

JSON.stringify(new Date("2011-07-29"))
// "2011-07-29T00:00:00.000Z"

toJSON方法的一個(gè)應(yīng)用是，可以將正則對(duì)象自動(dòng)轉(zhuǎn)為字符串。

RegExp.prototype.toJSON = RegExp.prototype.toString;

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

上面代碼，在正則對(duì)象的原型上面部署了toJSON方法，將其指向toString方法，因此遇到轉(zhuǎn)換成JSON時(shí)，就正則對(duì)象就先調(diào)用toJSON方法轉(zhuǎn)為字符串，然后再被JSON.stingify方法處理。

JSON.parse()

JSON.parse方法用于將JSON字符串轉(zhuǎn)化成對(duì)象。

JSON.parse('{}') // {}
JSON.parse('true') // true
JSON.parse('"foo"') // "foo"
JSON.parse('[1, 5, "false"]') // [1, 5, "false"]
JSON.parse('null') // null

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

如果傳入的字符串不是有效的JSON格式，JSON.parse方法將報(bào)錯(cuò)。

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

上面代碼中，雙引號(hào)字符串中是一個(gè)單引號(hào)字符串，因?yàn)閱我?hào)字符串不符合JSON格式，所以報(bào)錯(cuò)。

為了處理解析錯(cuò)誤，可以將JSON.parse方法放在try...catch代碼塊中。

JSON.parse方法可以接受一個(gè)處理函數(shù)，用法與JSON.stringify方法類(lèi)似。

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

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

參考鏈接

• MDN, 

  Using native JSON

• MDN, 

  JSON.parse

• Dr. Axel Rauschmayer, 

  JavaScript’s JSON API

• Jim Cowart, 

  What You Might Not Know About JSON.stringify()

• Marco Rogers polotek, 

  What is JSON?