前言
在开发工作中,我们可能会碰到这样的需求:需要将某个对象内容弹窗显示或者保存在文件中,这时候如果你直接弹窗的话,很可能就是下面这样的:
因为很多接口它对参数有要求,比如只能是字符串之类的。
这时候,就需要我们将对象转换为字符串进行输出,JSON.stringify() 方法就可以帮我们实现将对象转为字符串的过程。
方法描述
JSON.stringify() 方法将一个 JavaScript 对象或值转换为 JSON 字符串,如果指定了一个 replacer 函数,则可以选择性地替换值,或者指定的 replacer 是数组,则可选择性地仅包含数组指定的属性。
语法
JSON.stringify(value[, replacer [, space]])
参数说明:
- value 将要序列化成 一个 JSON 字符串的值。
- replacer(可选)如果该参数是一个函数,则在序列化过程中,被序列化的值的每个属性都会经过该函数的转换和处理;如果该参数是一个数组,则只有包含在这个数组中的属性名才会被序列化到最终的 JSON 字符串中;如果该参数为 null 或者未提供,则对象所有的属性都会被序列化。
- space(可选) 指定缩进用的空白字符串,用于美化输出(pretty-print);如果参数是个数字,它代表有多少的空格;上限为10。如果省略space,则将生成返回值文本,而没有任何额外空格。如果 space是一个数字,则返回值文本在每个级别缩进指定数目的空格。 如果 space 大于 10,则文本缩进 10 个空格。如果 space是一个非空字符串(例如“t”),则返回值文本在每个级别中缩进字符串中的字符。如果 space 是长度大于 10个字符的字符串,则使用前 10 个字符。
返回值
一个表示给定值的JSON字符串。
常规用法
console.log(JSON.stringify({name: "obj"}))
// '{"name": "obj"}'
repalacer 参数
replacer 参数可以是一个函数或者一个数组。作为函数,它有两个参数,键(key)和值(value),它们都会被序列化。
在开始时, replacer 函数会被传入一个空字符串作为 key 值,代表着要被 stringify 的这个对象。随后每个对象或数组上的属性会被依次传入。
函数应当返回JSON字符串中的value, 如下所示:
- 如果返回一个 Number,转换成相应的字符串作为属性值被添加入 JSON 字符串。
- 如果返回一个 String,该字符串作为属性值被添加入 JSON 字符串。
- 如果返回一个 Boolean, “true” 或者 “false” 作为属性值被添加入 JSON 字符串。
- 如果返回任何其他对象,该对象递归地序列化成 JSON 字符串,对每个属性调用 replacer 方法。除非该对象是一个函数,这种情况将不会被序列化成 JSON 字符串。
- 如果返回 undefined,该属性值不会在 JSON 字符串中输出。
有以下对象:
const data = [
{
name: "person1",
sex: 0,
age: 18,
isStudent: true
},
{
name: "person2",
sex: 1,
age: 25,
isStudent: false
},
{
name: "person3",
sex: 0,
age: 15,
isStudent: true
}
]
接下来我们针对这个对象做各种需求实现。
只输出姓名和性别
const res = JSON.stringify(data, ["name", "sex"])
console.log(res);
// `[{"name":"person1","sex":0},{"name":"person2","sex":1},{"name":"person3","sex":0}]`
JSON.stringify() 提供了分离出自己需要的那部分数据。
将性别转为中文字符
const res = JSON.stringify(data, (key, value) => {
if (key == 'sex') {
return ["女", '男'][value];
}
return value;
})
console.log(res);
// `[{"name":"person1","sex":"女","age":18,"isStudent":true},{"name":"person2","sex":"男","age":25,"isStudent":false},{"name":"person3","sex":"女","age":15,"isStudent":true}]`
JSON.stringify() 提供了回调函数做一个映射关系。
space 参数
const res = JSON.stringify(data, ["name", "sex"],4)
console.log(res);
输出如下:
这里使用了 4 个空格作为层级缩进。
注意:使用 “t” 得到的结果和使用 4 个空格得到的结果看起来很像,但实际不是一回事。
总结
JSON.stringify() 方法可以通过参数控制输出的数据和格式,灵活应用它会大大提高我们的工作效率。