JSON.stringify() 详解

该函数的作用是：系列化对象 
系列化对象说白了就是把对象的类型转换为字符串类型

---

语法

JSON.stringify(value[, replacer [, space]])

• value 
  将要序列化成 一个JSON 字符串的值。
• replacer 可选 
  可以为数组或函数 
  1. 如果为数组：则只有包含在这个数组中的属性名才会被序列化到最终的 JSON 字符串中，replacer作key值（这个在讲实例的时候就知道这个key是干嘛的了，先记住就好）
  2. 如果为函数：则把系列化后的每一个对象（记住是每一个）传进方法里面进行处理
• space 可选 
  指定缩进用的空白字符串 
  1. 如果省略的话，那么显示出来的值就没有分隔符。直接输出来
  2. 如果是一个数字的话，那么它就定义缩进几个字符，范围是：0到10（数字小于1，则默认为0，大于10，则默认为10）
  3. 如果是一些转义字符，比如“\t”，表示回车，那么它每行一个回车。
  4. 如果仅仅是字符串，就在每行输出值的时候把这些字符串附加上去就OK。当然，最大长度也是10个字符

实例说明

注意：以下的输出结果都是string类型的，为了容易看就没有用单引号‘’表明是字符串类型

只有一个参数

参数为对象：

var students = new Array();
students[0] = "pika";
students[1] = "hello";
students[2] = "hey";
var json = JSON.stringify(students);
alert(json);

输出结果：["pika","hello","hey"]

如果不用JSON.stringify()函数，直接alert(students)，那么

输出结果：pika,hello,hey

从这里到对比可以比较直观的看出JSON.stringify()函数的作用啦

看一下其他例子：

JSON.stringify({});                        // 输出结果：{}
JSON.stringify(true);                      // 输出结果：true
JSON.stringify("foo");                     // 输出结果："foo"
JSON.stringify([1, "false", false]);       // 输出结果：[1,"false",false]
JSON.stringify({ x: 5 });                  // 输出结果：{"x":5}

JSON.stringify({x: 5, y: 6});              
//输出结果：{"x":5,"y":6}

JSON.stringify([new Number(1), new String("false"), new Boolean(false)]); 
//输出结果：[1,"false",false]               

从这些例子中可以看出：布尔值、数字、字符串的包装对象在序列化过程中会自动转换成对应的原始值

再看一下其他例子：

JSON.stringify({x: undefined, y: Object, z: Symbol("")}); 
// 输出结果：{}

JSON.stringify([undefined, Object, Symbol("")]);          
// 输出结果：[null,null,null]'

JSON.stringify({[Symbol("foo")]: "foo"});                 
// 输出结果：{}

JSON.stringify({[Symbol.for("foo")]: "foo"}, [Symbol.for("foo")]);
// 输出结果：{}

JSON.stringify(
    {[Symbol.for("foo")]: "foo"}, 
    function (k, v) {
        if (typeof k === "symbol"){
            return "a symbol";
        }
    }
);
//输出结果：undefined 

从这些例子中可以看出：undefined、任意的函数以及 symbol 值，在序列化过程中会被忽略（出现在非数组对象的属性值中时）或者被转换成 null（出现在数组中时）

再看最后一个例子

JSON.stringify( 
    Object.create(
        null, 
        { 
            x: { value: 'x', enumerable: false }, 
            y: { value: 'y', enumerable: true } 
        }
    )
);

从例子中可以看出：不可枚举的属性会被忽略

有两个参数，第二个参数为函数

函数例子：

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

可以看出有一个key值，一个value值，还记得一开始说的第二个参数作key值吗？

实例：

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}

就是把第一个值传去函数进行相关的处理

有两个参数，第二个参数为数组

第一个参数为数组

var students = new Array();
students[0] = "pika";
students[1] = "hello";
students[2] = "hey";
var stu= new Array();
stu[0] = "how";
stu[1] = "are";
stu[2] = "u";
var json = JSON.stringify(students,stu);
alert(json);
//输出结果：["pika","hello","hey"]

结果是只有第一个值序列化了，第二个被忽略了

第一个参数为对象

var students = new Object();
students.name = "pika";
students.age = 19;
students.qq = "12345678";
var stu= new Array();
stu[0] = "name";
stu[1] = "qq";
var json = JSON.stringify(students,stu);
alert(json);
//输出结果：{"name":"pika","qq":"12345678"}

数组的值代表将被序列化成JSON字符串的属性名 
stu数组没有“age”，所以students对象的“age”属性没有显示

有三个参数

前面说到第三个参数就是用来缩进或者直接添加字符串在序列化对象的前面，所以直接看例子就行啦，注意最多只能10个缩进或字符

JSON.stringify({ a: 2 }, null, " ");   
// 输出结果：{\n "a": 2\n}

JSON.stringify({ uno: 1, dos : 2 }, null, '\t')
/* 输出结果：
{
    "uno": 1,
    "dos": 2
}
*/

var students = new Object();
students.name = "pika";
students.age = 19;
students.qq = "12345678";
var stu= new Array();
stu[0] = "name";
stu[1] = "qq";
var json = JSON.stringify(students,stu,"test")
alert(json);
/* 输出结果：
{
test"name": "pika",
test"qq": "12345678"
}
*/

如果我们还想要精确控制如何序列化小明，可以给对象定义一个toJSON()的方法，直接返回JSON应该序列化的数据：

var xiaoming = {
    name: '小明',
    age: 14,
    gender: true,
    height: 1.65,
    grade: null,
    'middle-school': '\"W3C\" Middle School',
    skills: ['JavaScript', 'Java', 'Python', 'Lisp'],
    toJSON: function () {
        return { // 只输出name和age，并且改变了key：
            'Name': this.name,
            'Age': this.age
        };
    }
};

JSON.stringify(xiaoming); // '{"Name":"小明","Age":14}'

总结

最后来总结一下，JSON.stringify()函数是用来序列化对象的，无论输入什么，输出的都是字符串类型，可以按自己的需求来定制如何序列化，输出结果是怎样的格式