到底什么是 JSON.stringify 方法?MDN
**JSON.stringify()**
方法将一个 JavaScript 对象或值转换为 JSON 字符串,如果指定了一个 replacer 函数,则可以选择性地替换值,或者指定的 replacer 是数组,则可选择性地仅包含数组指定的属性
方法基本介绍
- JSON.stringify 是日常开发中经常用到的 JSON 对象中的一个方法,
- JSON 对象包含两个方法:
- 一是用于解析成 JSON 对象的 parse();
- 二是用于将对象转换为 JSON 字符串方法的 stringify()。
两个方法的基本使用情况。
JSON.parse()
- JSON.parse 方法用来解析 JSON 字符串,构造由字符串描述的 JavaScript 值或对象。
- 该方法的语法为:JSON.parse(text[, reviver])
- 该方法有两个参数:
- 第一个参数是需要解析处理的 JSON 字符串,
- 第二个参数是可选参数提供可选的 reviver 函数,用在返回之前对所得到的对象执行变换操作。
这个方法以及 reviver 参数的用法,如下所示。
const json = '{"result":true, "count":2}';
const obj = JSON.parse(json);
console.log(obj.count); // 2
console.log(obj.result);// true
/ 带第二个参数的情况 /
JSON.parse('{"p": 5}', function (k, v) {
if(k === '') return v; // 如果k不是空就返回 v,
return v * 2; // 就将属性值变为原来的2倍返回
}); // {p: 10}
- 上面的代码说明了,我们可以将一个符合 JSON 格式的字符串转化成对象返回;带第二个参数的情况,可以将待处理的字符串进行一定的操作处理,比如上面这个例子就是将属性值乘以 2 进行返回。
JSON.stringify()
- JSON.stringify 方法是将一个 JavaScript 对象或值转换为 JSON 字符串;
- 该方法的语法为:JSON.stringify(value[, replacer [, space]])
- 默认该方法其实有三个参数:
- 第一个参数是必选,后面两个是可选参数非必选。第一个参数传入的是要转换的对象;
- 第二个是一个 replacer 函数,比如指定的 replacer 是数组,则可选择性地仅处理包含数组指定的属性;
- 第三个参数用来控制结果字符串里面的间距,后面两个参数整体用得比较少。
JSON.stringify({ x: 1, y: 2 }); // "{"x":1,"y":2}"
JSON.stringify({ x: [10, undefined, function(){}, Symbol('')] }); // "{"x":[10,null,null,null]}"
/* 第二个参数的例子*/
function replacer(key, value) {
if (typeof value === "string") {
return undefined;
}
return value;
}
let foo = { foundation: "Mozilla", model: "box", week: 4, transport: "car", month: 7 };
let jsonString = JSON.stringify(foo, replacer);
console.log(jsonString); // "{"week":4,"month":7}"
/* 第三个参数的例子 */
JSON.stringify({ a: 2 }, null, " "); // "{ "a" : 2 }"
JSON.stringify({ a: 2 }, null, ""); // "{ "a" : 2 }"
- 增加第二个参数 replacer 带来的变化:通过替换方法把对象中的属性为字符串的过滤掉,在 stringify 之后返回的仅为数字的属性变成字符串之后的结果;当第三个参数传入的是多个空格的时候,则会增加结果字符串里面的间距数量,从最后一段代码中可以看到结果。
如何自己手动实现?
输入 | 输出 | |
---|---|---|
基础数据类型 | undefined | undefined |
boolean | true/false | |
number | 字符串类型的数值 | |
symbol | undefined | |
null | null | |
string | string | |
NaN和infinity | null | |
引用数据类型 |
function | undefined |
array数组中出现了undefined、function以及symbol | string/null | |
RegExp | “{}” | |
Date | Date的toJSON()字符串值 | |
普通object | - 如果有toJSON()方法,那么序列化toJSON()的返回值 - 如果属性值中出现undefined、任意的函数以及symbol值,忽略 - 所有以symbol为属性键的属性都会被完全忽略掉 |
- 上面这个表中,基本整理出了各种数据类型通过 JSON.stringify 这个方法之后返回对应的值,但是还有一个特殊情况需要注意:对于包含循环引用的对象(深拷贝那讲中也有提到)执行此方法,会抛出错误。
- 代码逻辑实现
- 利用 typeof 把基础数据类型和引用数据类型分开,分开之后再根据不同情况来分别处理不同的情况,按照这个逻辑代码实现如下。
function jsonStringify(data) {
const type = typeof (data);
if (type !== 'object') {
let result = data;
if (Number.isNaN(data) || data === Infinity) result = "null";
else if (['function', 'undefined', 'symbol'].includes(type)) return undefined;
else if (type === "string") result = `"${data}"`;
return String(result);
}
else if (type === 'object') {
if (data === null) return "null" // typeof null 为'object'的特殊情况
else if (data.toJSON && typeof data.toJSON === 'function') return jsonStringify(data.toJSON());
else if (data instanceof Array) {
let result = [];
//如果是数组,那么数组里面的每一项类型又有可能是多样的
data.forEach((item, index) => (result[index] = ['undefined', 'function', 'symbol'].includes(typeof item) ? "null" : jsonStringify(item)));
result = "[" + result + "]";
return result.replace(/'/g, '"');
}
else {
// 处理普通对象
let result = [];
Object.keys(data).forEach((item, index) => {
if (typeof item !== 'symbol') {
//key 如果是 symbol 对象,忽略
const type = typeof data[item]
if (type !== 'undefined' && type !== 'function' && type !== 'symbol') {
//键值如果是 undefined、function、symbol 为属性值,忽略
// result.push('"' + item + '"' + ":" + jsonStringify(data[item]));
result.push(`"${item}":${jsonStringify(data[item])}`);
}
}
});
// return ("{" + result + "}").replace(/'/g, '"');
return (`{${result}}`).replace(/'/g, '"');
}
}
}
Tips:
- 由于 function 返回 ‘null’, 并且 typeof function 能直接返回精确的判断,故在整体逻辑处理基础数据类型的时候,会随着 undefined,symbol 直接处理了;
- 由于 01 讲说过 typeof null 的时候返回’object’,故 null 的判断逻辑整体在处理引用数据类型的逻辑里面;
- 关于引用数据类型中的数组,由于数组的每一项的数据类型又有很多的可能性,故在处理数组过程中又将 undefined,symbol,function 作为数组其中一项的情况做了特殊处理;
- 同样在最后处理普通对象的时候,key (键值)也存在和数组一样的问题,故又需要再针对上面这几种情况(undefined,symbol,function)做特殊处理;
- 最后在处理普通对象过程中,对于循环引用的问题暂未做检测,如果是有循环引用的情况,需要抛出 Error;
let nl = null;
console.log(jsonStringify(nl) === JSON.stringify(nl));
// true
let und = undefined;
console.log(jsonStringify(undefined) === JSON.stringify(undefined));
// true
let boo = false;
console.log(jsonStringify(boo) === JSON.stringify(boo));
// true
let nan = NaN;
console.log(jsonStringify(nan) === JSON.stringify(nan));
// true
let inf = Infinity;
console.log(jsonStringify(Infinity) === JSON.stringify(Infinity));
// true
let str = "jack";
console.log(jsonStringify(str) === JSON.stringify(str));
// true
let reg = new RegExp("\w");
console.log(jsonStringify(reg) === JSON.stringify(reg));
// true
let date = new Date();
console.log(jsonStringify(date) === JSON.stringify(date));
// true
let sym = Symbol(1);
console.log(jsonStringify(sym) === JSON.stringify(sym));
// true
let array = [1,2,3];
console.log(jsonStringify(array) === JSON.stringify(array));
// true
let obj = {
name: 'jack',
age: 18,
attr: ['coding', 123],
date: new Date(),
uni: Symbol(2),
sayHi: function() {
console.log("hi")
},
info: {
sister: 'lily',
age: 16,
intro: {
money: undefined,
job: null
}
}
}
console.log(jsonStringify(obj) === JSON.stringify(obj));
// true
Tasking
- 逻辑判断尝试使用switch重构
- 类型健壮性和容错处理
复制代码
通过上面这些测试的例子可以发现,我们自己实现的 jsonStringify 方法基本和 JSON.stringify 转换之后的结果是一样的,不难看出 jsonStringify 基本满足了预期结果。