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 中运行:
const user = {
id: 7,
name: "Lin",
active: true,
tags: ["js", "json"],
note: null
};
const jsonText = JSON.stringify(user, null, 2);
console.log(jsonText);预期输出:
{
"id": 7,
"name": "Lin",
"active": true,
"tags": [
"js",
"json"
],
"note": null
}此时 jsonText 的类型是字符串,而不是对象。双引号、冒号和逗号都属于 JSON 文本的一部分,适合写入文件、请求体或存储系统。
从 JSON 文本恢复数据
JSON.parse(text) 只接受合法 JSON 文本。解析成功后,会根据 JSON 中的对象、数组、字符串、数字、布尔值和 null 创建对应的 JavaScript 值。
继续使用上一步得到的 jsonText:
const restored = JSON.parse(jsonText);
console.log(restored.name);
console.log(restored.tags[1]);
console.log(restored.note === null);预期输出:
Lin
json
true解析结果是新的 JavaScript 数据结构,与原对象不是同一个引用。JSON 只保存数据内容,不会保留原对象的方法、原型链或类实例身份。
JSON 格式有哪些限制
JSON 的数据类型比 JavaScript 少。字符串和属性名必须使用双引号;不能写注释、尾随逗号、undefined、函数、Symbol,也不能直接表示 BigInt。
序列化时还要注意几种行为:对象属性值为 undefined、函数或 Symbol 时,该属性会被忽略;数组中的这些值会变成 null;NaN 和 Infinity 会变成 null;直接序列化 BigInt 会抛出 TypeError。
const value = {
kept: 1,
skipped: undefined,
notNumber: NaN
};
console.log(JSON.stringify(value));
console.log(JSON.stringify([undefined, NaN]));预期输出:
{"kept":1,"notNumber":null}
[null,null]解析失败时如何判断
当文本存在单引号属性名、注释、尾随逗号或其他非法语法时,JSON.parse 会抛出 SyntaxError。处理外部输入时,应把“文本是否合法”与“字段是否符合业务要求”分开:先完成 JSON 语法解析,再检查必填字段、类型和取值范围。
如果数据只在 JavaScript 内部短暂使用,不需要跨进程、跨语言或持久化,就不必为了“统一格式”反复 stringify 和 parse。JSON 最适合承担数据交换文本格式,而不是替代 JavaScript 自身的数据结构。