JavaScript / TypeScript / 系统课时

JSON 序列化与解析

JSON 序列化与解析

前后端传输、缓存或持久化数据时,JavaScript 对象通常需要先转换成 JSON 文本,再在接收端恢复。本篇用完整示例掌握 JSON.stringify、JSON.parse 的基本用法,并辨清 JSON 与 JavaScript 对象在类型和语法上的边界。

学习目标

  • 使用 JSON.stringify 将可序列化的 JavaScript 数据转换为 JSON 字符串。
  • 使用 JSON.parse 将合法 JSON 文本还原为 JavaScript 值。
  • 判断 undefined、函数、BigInt 等值在 JSON 序列化中的限制。

从对象得到 JSON 字符串

JSON.stringify(value) 接收 JavaScript 值并返回 JSON 字符串。第二、第三个参数还能控制属性筛选和缩进;学习阶段常用 JSON.stringify(value, null, 2) 生成便于阅读的文本。

下面的示例可直接在浏览器控制台或 Node.js 中运行:

js
const user = {
  id: 7,
  name: "Lin",
  active: true,
  tags: ["js", "json"],
  note: null
};

const jsonText = JSON.stringify(user, null, 2);
console.log(jsonText);

预期输出:

text
{
  "id": 7,
  "name": "Lin",
  "active": true,
  "tags": [
    "js",
    "json"
  ],
  "note": null
}

此时 jsonText 的类型是字符串,而不是对象。双引号、冒号和逗号都属于 JSON 文本的一部分,适合写入文件、请求体或存储系统。

从 JSON 文本恢复数据

JSON.parse(text) 只接受合法 JSON 文本。解析成功后,会根据 JSON 中的对象、数组、字符串、数字、布尔值和 null 创建对应的 JavaScript 值。

继续使用上一步得到的 jsonText:

js
const restored = JSON.parse(jsonText);
console.log(restored.name);
console.log(restored.tags[1]);
console.log(restored.note === null);

预期输出:

text
Lin
json
true

解析结果是新的 JavaScript 数据结构,与原对象不是同一个引用。JSON 只保存数据内容,不会保留原对象的方法、原型链或类实例身份。

JSON 格式有哪些限制

JSON 的数据类型比 JavaScript 少。字符串和属性名必须使用双引号;不能写注释、尾随逗号、undefined、函数、Symbol,也不能直接表示 BigInt。

序列化时还要注意几种行为:对象属性值为 undefined、函数或 Symbol 时,该属性会被忽略;数组中的这些值会变成 null;NaN 和 Infinity 会变成 null;直接序列化 BigInt 会抛出 TypeError。

js
const value = {
  kept: 1,
  skipped: undefined,
  notNumber: NaN
};

console.log(JSON.stringify(value));
console.log(JSON.stringify([undefined, NaN]));

预期输出:

text
{"kept":1,"notNumber":null}
[null,null]

解析失败时如何判断

当文本存在单引号属性名、注释、尾随逗号或其他非法语法时,JSON.parse 会抛出 SyntaxError。处理外部输入时,应把“文本是否合法”与“字段是否符合业务要求”分开:先完成 JSON 语法解析,再检查必填字段、类型和取值范围。

如果数据只在 JavaScript 内部短暂使用,不需要跨进程、跨语言或持久化,就不必为了“统一格式”反复 stringify 和 parse。JSON 最适合承担数据交换文本格式,而不是替代 JavaScript 自身的数据结构。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

JSON 序列化与解析

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通