介绍
什么是序列化,序列化就是将对象数据转换为可以存储或者传输的过程。在js中,经常使用JSON来进行数据的序列化和反序列化,需要注意的是JavaScript不是JSON,JSON也不是JavaScript。
虽然JSON是基于JavaScript语法,但是JSON并不是Javascript的子集。JSON序列化是将对象或值转换为JSON字符串,并提供对应的解析JSON字符串的方法。
语法
JSON.stringify(value[, replacer [, space]])
可将一个js对象或值转换为JSON字符串,其一共有三个参数,如果指定了replacer且为函数,则被序列化的每一个值都会经过此函数的处理;如果replacer为数组,则只有在数组中的属性才会被序列化。
value
:将要被序列化的值,可为js对象或普通值
replacer
:可选参数
- 如果该参数指定为一个函数,则在序列化的过程中,被序列化的值的每一个属性都将经过函数的转换和处理,最终的JSON字符串将与函数有关
- 如果该参数指定为一个数组,则在序列化的过程中,只有包含在数组中的属性名才会被序列化,最终的JSON字符串与原数据相比是做了“过滤”
- 如果该参数未指定、指定为null或指定为其他值,则在序列化的过程中,所有的属性都将被序列化
space
:可选参数
- 指定用于缩进的空白字符串个数
- 如果参数的值为数字,则表示有多少个空格;最大值为10,若小于1,则表示没有空格
- 如果参数的值为字符串,则该字符串被视为空格,用于美化输出;如果字符串长度超过10,则截取前10
- 如果没有提供,或提供为null,则表示没有空格
异常情况
- 尝试转换循环引用时,会抛出异常
- 尝试转换BigInt类型时,也会抛出异常
- 如果不确定被转换数据的类型,可将
JSON.stringify()
放入try/catch中执行
案例
value
将对象或值转换为JSON字符串
- 如果被转换对象中含有toJSON() 方法,则最终的JSON字符串有
toJSON()
决定,因此需要注意不能在方法中轻易覆盖此方法。 - 非数组对象在被序列化后,不保证其属性还是按照特定的顺序出现在JSON字符串
- 布尔值、数字、字符串的包装类型,即通过
new Boolean()
、new Number()
、new String()
创建的数据,在转换时会自动转换成对应的基本数据类型 - 函数、undefined单独被转换时,会返回undefined;函数、undefined、symbol在序列化过程中,如果出现在数组中则转换为null,如果为非数组的属性则会被忽略
- 无法转换存在循环引用的对象
- NaN、Infinity、null都会被转换为null
- 所有以symbol为键的属性都会被忽略掉,即使在replacer函数中强制指定了需要包含这些属性
- 其他类型的对象,则仅会序列化可枚举属性
// 基础值和对象 JSON.stringify({}) // '{}' JSON.stringify('str') // '"str"' JSON.stringify("str") // '"str"' JSON.stringify(true) // 'true' JSON.stringify([new Number(2), new String('true'), new Boolean(true)]) // 包装类型,转换为对应的基本类型。'[1, "true", true]' JSON.stringify(undefined) // 单独转换,undefined JSON.stringify(function () {}) // 单独转换,undefined JSON.stringify([undefined, function () {}, Object, Symbol(1)]) // 如果出现在数组中,则转换为null,'[null, null,null, null]' JSON.stringify({x:undefined, y:function () {}, Object, z:Symbol(1)}) // 如果出现在非数组对象中,则会被忽略,'{}' // 以Symbol为键的属性都会被忽略 JSON.stringify({[Symbol('key')]: 'value'}) // '{}', 忽略Symbol JSON.stringify({[Symbol('key')]: 'value'}, [Symbol('key')]) // '{}', 就算数组中包含也会忽略 JSON.stringify({[Symbol('key')]: 'value'}, function (k, v) { if (k === 'symbol') { return 'symbol' } }) // undefined, 就算是在replacer中强制指定,也会被忽略 JSON.stringify(NaN) // null JSON.stringify(null) // null JSON.stringify(Infinity) // null
replacer
replacer可以是一个函数,也可是一个数组。如果是函数,则有两个参数,分别为key和value,两者都可以被序列化;如果是数组,则仅在数组中的属性会被序列化。
function replacer (key, value) { if (typeof value === 'boolean') { return undefined; } else if (typeof value === 'string') { return { flag: true } } else if (typeof value === 'number') { return function () { console.log('value', value) } } else if (Array.isArray(value)) { return { isArr: true }; } return value } let obj = { bool: false, str: 'hello', num: 10, arr: [20] } let jsonStr = JSON.stringify(obj, replacer); // '"str": {}, "arr": {}' // 如果返回为undefined,则该属性不会显示在JSON字符串中 // 如果返回为对象,则该对象递归调用replacer序列化成JSON字符串 // 如果返回为函数,则该函数不会被序列化成JSON字符串 // 由于存在递归调用,因此需要避免超出最大调用栈 jsonStr = JSON.stringify(obj, ['bool', 'num']) // '{"bool": false, "num": 10}', 如果是数组,则仅会序列化数组中的属性
space
用来控制序列化后的JSON字符串里面空格的间距。如果是数字,则表示缩进多少个空格;如果是字符串,则用该字符串代替空格。space的最大长度为10
JSON.stringify({ x: 10, y: 20 }, null, 4); // '{\n "x": 10,\n "y": 20\n}' JSON.stringify({ x: 10, y: 20 }, null, 'hello'); // '{\nhello"x": 10,\nhello"y": 20\n}'
toJSON
如果一个被序列化的对象拥有toJSON方法,则该方法就会覆盖默认的序列化行为,即不是该对象被序列化,而是调用toJSON方法后返回的值被序列化。
let obj = { x: 10, y: 30, toJSON: function() { return {z: 40}; } }; JSON.stringify(obj); // '30',序列化的是toJSON返回的值,而不是整个对象 JSON.stringify({x: obj}, function(k, v) { if (v.z == 40) { return {z: 50} } return v; }); // '{"x":{"z":50}}',使用replacer函数处理的也是处理的是toJSON返回的值,而不是整个对象
总结
- JSON可使用stringify方法实现对象或值的序列化
- replacer参数可以是函数,也可以是数组。函数用来处理被序列化的值的每一个属性,数组表示只序列化哪些属性,两者可以在某些场景下实现相同的效果
- 被序列化的对象如果有toJSON方法,则序列化的是该方法返回的值
- JSON.stringify可与localStorage结合使用,用于存储登录信息等;也可用于简单的深拷贝
- 合理使用第二个参数replacer,可更好的处理序列化对象时可能被忽略、转换的属性值
- 在序列化时可能会抛出异常,可将其放入try/catch中执行
以上就是JavaScript语法 JSON序列化之stringify实例详解的详细内容,更多关于JavaScript JSON 序列化 stringify的资料请关注阿兔在线工具其它相关文章!