JSON 格式

一：JSON 格式定义

JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。 易于人阅读和编写。同时也易于机器解析和生成。2001年由 Douglas Crockford 提出，目的是取代繁琐笨重的 XML 格式。

二、JSON 格式规则

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

空数组和空对象都是合格的 JSON 值，null本身也是一个合格的 JSON 值

以下是合格的 JSON 值。

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

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

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

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

以下是不合格的 JSON 值。

{ name: "张三", 'age': 32 }  // 属性名必须使用双引号

[32, 64, 128, 0xFFF] // 不能使用十六进制值

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

{ "name": "张三",
  "birthday": new Date('Fri, 26 Aug 2011 07:13:10 GMT'),
  "getName": function() {
      return this.name;
  }
} // 不能使用函数和日期对象

三、处理 JSON 格式数据的方法

1、JSON.Stringify

1）用途
用于将一个值转为字符串。该字符串符合 JSON 格式，并且可以被JSON.parse方法还原。
2)参数
JSON.stringify(value[, replacer [, space]])

2.1 value：将要序列化成 一个JSON 字符串的值
2.2 replacer （可选）

• 如果该参数是一个函数，则在序列化过程中，被序列化的值的每个属性都会经过该函数的转换和处理

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

var foo = {foundation: "Mozilla", model: "box", week: 45, transport: "car", month: 7};
var jsonString = JSON.stringify(foo, replacer);
//{"week":45,"month":7}.

• 如果该参数是一个数组，则只有包含在这个数组中的属性名才会被序列化到最终的 JSON 字符串中。

var foo = {foundation: "Mozilla", model: "box", week: 45, transport: "car", month: 7};
JSON.stringify(foo, ['week', 'month']);  
// '{"week":45,"month":7}', 只保留“week”和“month”属性值。

• 如果该参数为null或者未提供，则对象所有的属性都会被序列化；

2.3 space 参数（可选）
space 参数用来控制结果字符串里面的间距

• 如果是数字, 则在转换时每一级别会比上一级别缩进对应 数字值的空格（最多10个空格）

• 如果是一个字符串，则每一级别加上该字符串（或该字符串的前十个字符）

3)举个例子

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":"张三"}"

4）总结
先写""转换为字符串格式，再把需要转换的内容按照json格式的规则转变一下，该加""的加"",然后把转换后的内容放在""内，收工

5)特例
json格式不支持的内容会被过滤，分3种情况

1. 原始对象

原始对象成员的值是undefined、函数或 XML 对象，这个成员会被过滤

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

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

2.数组
数组的成员是undefined、函数或 XML 对象，则这些值被转成null

var arr = [undefined, function () {}];
JSON.stringify(arr) // "[null,null]"

3.正则对象
正则对象会被转成空对象。

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

2、JSON.parse()

1）用途
JSON.parse方法用于将JSON格式的字符串转化成对象。
2)参数
JSON.parse(text[, reviver])
2.1 text
要被解析成JavaScript值的字符串

2.2 reviver 可选
转换器, 如果传入该参数(函数)，可以用来修改解析生成的原始值，调用时机在parse函数返回之前。

JSON.parse('{"p": 5}', function (k, v) {
    if(k === '') return v;     // 如果到了最顶层，则直接返回属性值，
    return v * 2;              // 否则将属性值变为原来的 2 倍。
});                            // { p: 10 }

3)举个例子

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 // 张三

4）特例
如果传入的字符串不是有效的JSON格式，JSON.parse方法将报错。

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

5）遇到的坑
红框里面一个加的是单引号，一个加双引号，两个运行起来都没有错。
这代表是用于表示值为字符串的引号，使用单双引号都可以，但表示内容为json格式的引号必须写双引号

部分内容源于mdn文档
JSON.parse()
JSON.stringify()