到底什么是 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 参数的用法,如下所示。

    1. const json = '{"result":true, "count":2}';
    2. const obj = JSON.parse(json);
    3. console.log(obj.count); // 2
    4. console.log(obj.result);// true
    5. / 带第二个参数的情况 /
    6. JSON.parse('{"p": 5}', function (k, v) {
    7. if(k === '') return v; // 如果k不是空就返回 v,
    8. return v * 2; // 就将属性值变为原来的2倍返回
    9. }); // {p: 10}
    • 上面的代码说明了,我们可以将一个符合 JSON 格式的字符串转化成对象返回;带第二个参数的情况,可以将待处理的字符串进行一定的操作处理,比如上面这个例子就是将属性值乘以 2 进行返回。
  • JSON.stringify()

    • JSON.stringify 方法是将一个 JavaScript 对象或值转换为 JSON 字符串;
    • 该方法的语法为:JSON.stringify(value[, replacer [, space]])
    • 默认该方法其实有三个参数:
    • 第一个参数是必选,后面两个是可选参数非必选。第一个参数传入的是要转换的对象;
    • 第二个是一个 replacer 函数,比如指定的 replacer 是数组,则可选择性地仅处理包含数组指定的属性;
    • 第三个参数用来控制结果字符串里面的间距,后面两个参数整体用得比较少。
  1. JSON.stringify({ x: 1, y: 2 }); // "{"x":1,"y":2}"
  2. JSON.stringify({ x: [10, undefined, function(){}, Symbol('')] }); // "{"x":[10,null,null,null]}"
  3. /* 第二个参数的例子*/
  4. function replacer(key, value) {
  5. if (typeof value === "string") {
  6. return undefined;
  7. }
  8. return value;
  9. }
  10. let foo = { foundation: "Mozilla", model: "box", week: 4, transport: "car", month: 7 };
  11. let jsonString = JSON.stringify(foo, replacer);
  12. console.log(jsonString); // "{"week":4,"month":7}"
  13. /* 第三个参数的例子 */
  14. JSON.stringify({ a: 2 }, null, " "); // "{ "a" : 2 }"
  15. 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 把基础数据类型和引用数据类型分开,分开之后再根据不同情况来分别处理不同的情况,按照这个逻辑代码实现如下。
  1. function jsonStringify(data) {
  2. const type = typeof (data);
  3. if (type !== 'object') {
  4. let result = data;
  5. if (Number.isNaN(data) || data === Infinity) result = "null";
  6. else if (['function', 'undefined', 'symbol'].includes(type)) return undefined;
  7. else if (type === "string") result = `"${data}"`;
  8. return String(result);
  9. }
  10. else if (type === 'object') {
  11. if (data === null) return "null" // typeof null 为'object'的特殊情况
  12. else if (data.toJSON && typeof data.toJSON === 'function') return jsonStringify(data.toJSON());
  13. else if (data instanceof Array) {
  14. let result = [];
  15. //如果是数组,那么数组里面的每一项类型又有可能是多样的
  16. data.forEach((item, index) => (result[index] = ['undefined', 'function', 'symbol'].includes(typeof item) ? "null" : jsonStringify(item)));
  17. result = "[" + result + "]";
  18. return result.replace(/'/g, '"');
  19. }
  20. else {
  21. // 处理普通对象
  22. let result = [];
  23. Object.keys(data).forEach((item, index) => {
  24. if (typeof item !== 'symbol') {
  25. //key 如果是 symbol 对象,忽略
  26. const type = typeof data[item]
  27. if (type !== 'undefined' && type !== 'function' && type !== 'symbol') {
  28. //键值如果是 undefined、function、symbol 为属性值,忽略
  29. // result.push('"' + item + '"' + ":" + jsonStringify(data[item]));
  30. result.push(`"${item}":${jsonStringify(data[item])}`);
  31. }
  32. }
  33. });
  34. // return ("{" + result + "}").replace(/'/g, '"');
  35. return (`{${result}}`).replace(/'/g, '"');
  36. }
  37. }
  38. }

Tips:

  • 由于 function 返回 ‘null’, 并且 typeof function 能直接返回精确的判断,故在整体逻辑处理基础数据类型的时候,会随着 undefined,symbol 直接处理了;
  • 由于 01 讲说过 typeof null 的时候返回’object’,故 null 的判断逻辑整体在处理引用数据类型的逻辑里面;
  • 关于引用数据类型中的数组,由于数组的每一项的数据类型又有很多的可能性,故在处理数组过程中又将 undefined,symbol,function 作为数组其中一项的情况做了特殊处理;
  • 同样在最后处理普通对象的时候,key (键值)也存在和数组一样的问题,故又需要再针对上面这几种情况(undefined,symbol,function)做特殊处理;
  • 最后在处理普通对象过程中,对于循环引用的问题暂未做检测,如果是有循环引用的情况,需要抛出 Error;
  1. let nl = null;
  2. console.log(jsonStringify(nl) === JSON.stringify(nl));
  3. // true
  4. let und = undefined;
  5. console.log(jsonStringify(undefined) === JSON.stringify(undefined));
  6. // true
  7. let boo = false;
  8. console.log(jsonStringify(boo) === JSON.stringify(boo));
  9. // true
  10. let nan = NaN;
  11. console.log(jsonStringify(nan) === JSON.stringify(nan));
  12. // true
  13. let inf = Infinity;
  14. console.log(jsonStringify(Infinity) === JSON.stringify(Infinity));
  15. // true
  16. let str = "jack";
  17. console.log(jsonStringify(str) === JSON.stringify(str));
  18. // true
  19. let reg = new RegExp("\w");
  20. console.log(jsonStringify(reg) === JSON.stringify(reg));
  21. // true
  22. let date = new Date();
  23. console.log(jsonStringify(date) === JSON.stringify(date));
  24. // true
  25. let sym = Symbol(1);
  26. console.log(jsonStringify(sym) === JSON.stringify(sym));
  27. // true
  28. let array = [1,2,3];
  29. console.log(jsonStringify(array) === JSON.stringify(array));
  30. // true
  31. let obj = {
  32. name: 'jack',
  33. age: 18,
  34. attr: ['coding', 123],
  35. date: new Date(),
  36. uni: Symbol(2),
  37. sayHi: function() {
  38. console.log("hi")
  39. },
  40. info: {
  41. sister: 'lily',
  42. age: 16,
  43. intro: {
  44. money: undefined,
  45. job: null
  46. }
  47. }
  48. }
  49. console.log(jsonStringify(obj) === JSON.stringify(obj));
  50. // true

Tasking

  • 逻辑判断尝试使用switch重构
  • 类型健壮性和容错处理

复制代码

通过上面这些测试的例子可以发现,我们自己实现的 jsonStringify 方法基本和 JSON.stringify 转换之后的结果是一样的,不难看出 jsonStringify 基本满足了预期结果。