JSON对象
来自《JavaScript 标准参考教程(alpha)》,by 阮一峰
目录以下是不合格的 JSON 值。
需要注意的是,空数组和空对象都是合格的 JSON 值,null本身也是一个合格的 JSON 值。
ES5 新增了JSON对象,用来处理 JSON 格式数据。它有两个方法:JSON.stringify()和JSON.parse()。
上面代码将各种类型的值,转成 JSON 字符串。
需要注意的是,对于原始类型的字符串,转换结果会带双引号。
上面代码中,字符串foo,被转成了""foo""。这是因为将来还原的时候,双引号可以让 JavaScript 引擎知道,foo是一个字符串,而不是一个变量名。
如果原始对象中,有一个成员的值是undefined、函数或 XML 对象,这个成员会被过滤。
上面代码中,对象obj的a属性是undefined,而b属性是一个函数,结果都被JSON.stringify过滤。
如果数组的成员是undefined、函数或 XML 对象,则这些值被转成null。
上面代码中,数组arr的成员是undefined和函数,它们都被转成了null。
正则对象会被转成空对象。
JSON.stringify方法会忽略对象的不可遍历属性。
上面代码中,bar是obj对象的不可遍历属性,JSON.stringify方法会忽略这个属性。
上面代码中,JSON.stringify方法的第二个参数指定,只转prop1和prop2两个属性。
这个类似“白名单”的数组,只对对象的属性有效,对数组无效。
上面代码中,第二个参数指定JSON格式只转0号属性,实际上对数组是无效的,只对对象有效。
第二个参数还可以是一个函数,用来更改JSON.stringify的默认行为。
上面代码中的f函数,接受两个参数,分别是被转换的对象的键名和键值。如果键值是数值,就将它乘以2,否则就原样返回。
注意,这个处理函数是递归处理所有的键。
上面代码中,对象o一共会被f函数处理三次。第一次键名为空,键值是整个对象o;第二次键名为a,键值是{b: 1};第三次键名为b,键值为1。
递归处理中,每一次处理的对象,都是前一次返回的值。
上面代码中,f函数修改了对象o,接着JSON.stringify方法就递归处理修改后的对象o。
如果处理函数返回undefined或没有返回值,则该属性会被忽略。
上面代码中,a属性经过处理后,返回undefined,于是该属性被忽略了。
现在,为这个对象加上toJSON方法。
上面代码中,JSON.stringify发现参数对象有toJSON方法,就直接使用这个方法的返回值作为参数,而忽略原对象的其他参数。
Date对象就有一个自己的toJSON方法。
上面代码中,JSON.stringify发现处理的是Date对象实例,就会调用这个实例对象的toJSON方法,将该方法的返回值作为参数。
toJSON方法的一个应用是,将正则对象自动转为字符串。因为JSON.stringify默认不能转换正则对象,但是设置了toJSON方法以后,就可以转换正则对象了。
上面代码在正则对象的原型上面部署了toJSON方法,将其指向toString方法,因此遇到转换成JSON时,正则对象就先调用toJSON方法转为字符串,然后再被JSON.stingify方法处理。
如果传入的字符串不是有效的JSON格式,JSON.parse方法将报错。
上面代码中,双引号字符串中是一个单引号字符串,因为单引号字符串不符合JSON格式,所以报错。
为了处理解析错误,可以将JSON.parse方法放在try...catch代码块中。
JSON.parse方法可以接受一个处理函数,用法与JSON.stringify方法类似。