JS怎么将JSON格式字符串转换为数组
详细讲解在JavaScript中如何将JSON格式字符串转换为数组。涵盖原生JSON.parse语法、防御式安全解析封装、对象与类数组转换、常见SyntaxError报错排查与大数精度处理。
一、标准场景:直接解析 JSON 数组字符串
当业务系统或后端接口返回的数据是一个标准格式的 JSON 数组字符串时,直接使用 JSON.parse() 是性能最高、最为直接的方案。
1. 基本类型数组转换
标准 JSON 数组字符串以外层中括号 [] 包裹,其中的字符串项必须用标准的英文双引号 "" 标注。代码如下:
// 待转换的字符串:必须以 [] 包裹,字符串必须是双引号
const jsonString = '["Vue", "React", "Angular"]';
// 核心转换语句
const frameworkArray = JSON.parse(jsonString);
// 验证输出与类型
console.log(frameworkArray); // 输出: ['Vue', 'React', 'Angular']
console.log(frameworkArray.length); // 输出: 3
console.log(Array.isArray(frameworkArray)); // 输出: true
此时 frameworkArray 已经成为标准的内存数组,可以无缝调用 forEach()、map()、filter() 等全部原生原型方法。
2. 对象数组(列表)转换
在网络请求(如 Fetch 或 Axios)中,更常见的形态是由多个 JSON 对象构成的列表字符串:
const userListJson = '[{"id": 1, "name": "张三"}, {"id": 2, "name": "李四"}]';
// 执行反序列化
const users = JSON.parse(userListJson);
console.log(users[0].name); // 输出: 张三
console.log(users.map(u => u.name)); // 输出: ['张三', '李四']
'["apple", "banana"]' 是合法 JSON;而 "['apple', 'banana']" 会直接触发解析语法错误。
二、标准操作步骤与防御式执行流程
在真实的业务链路中,外部传入的 JSON 字符串可能因网络截断、接口异常或人为输入而产生畸变。如果直接裸调 JSON.parse(),一旦字符串语法不合规,浏览器将抛出致命的 SyntaxError 并且中断当前线程运行。因此,标准的操作必须遵循严密的防御流程。
操作步骤拆解:
- 步骤 1(入参有效性判定):校验入参是否为
string类型,并调用trim()排除null、undefined或纯空白字符串。 - 步骤 2(建立防崩沙箱):将核心解析语句装入
try...catch块中,严防语法错误击溃调用链路。 - 步骤 3(核心原生解析):使用底层 C++ 编写的
JSON.parse()极速反序列化。 - 步骤 4(类型断言校验):利用
Array.isArray(result)判定结果。因为诸如'{}'、'123'、'null'等合法 JSON 字符串均不会被JSON.parse报错,但它们并非数组! - 步骤 5(降级默认交付):断言成功返回解析数组;若发生异常或类型不匹配,安全返回默认兜底数组
[]。
生产级封装:safeJsonToArray 函数
在企业级前端或 Node.js 项目中,推荐直接引入以下封装函数:
/**
* 安全地将 JSON 格式字符串解析转换为数组
* @param {string} jsonStr - 待解析的 JSON 字符串
* @param {Array} defaultValue - 出现异常或解析结果非数组时的默认返回值(默认为空数组)
* @returns {Array}
*/
function safeJsonToArray(jsonStr, defaultValue = []) {
// 1. 入参前置检查
if (typeof jsonStr !== 'string' || !jsonStr.trim()) {
return defaultValue;
}
// 2. 异常捕获沙箱
try {
const result = JSON.parse(jsonStr);
// 3. 严格断言是否为数组类型
if (Array.isArray(result)) {
return result;
}
console.warn('[safeJsonToArray] 解析成功但数据并非数组结构:', result);
return defaultValue;
} catch (error) {
// 4. 捕获并记录语法解析错误,返回兜底空数组
console.warn('[safeJsonToArray] JSON 语法解析失败:', error.message);
return defaultValue;
}
}
// 运行测试:
console.log(safeJsonToArray('["a", "b"]')); // 正常解析: ['a', 'b']
console.log(safeJsonToArray('{ "id": 1 }')); // 拦截对象并返回默认: []
console.log(safeJsonToArray('bad json str')); // 拦截语法错误返回默认: []
console.log(safeJsonToArray(null)); // 拦截非字符串参数返回默认: []
三、数据形态拓展:非标准数组 JSON 转数组方案
并非所有需要转为数组的数据一开始都是 [...] 形式。常常会遇到后端返回以 ID 为键的字典对象,或是带有数字索引的“类数组对象”。针对不同拓扑形态,需配合不同的内置方法。
1. 键值对象字符串:提取属性值或键名成数组
若 JSON 字符串是普通字典对象(形如 '{"apple": 10, "banana": 25, "orange": 18}'),直接 JSON.parse 得到的是 Object。此时可通过 Object.values()、Object.keys() 或 Object.entries() 完成转换:
const mapJson = '{"apple": 10, "banana": 25, "orange": 18}';
const rawObj = JSON.parse(mapJson);
// 方案 A: 获取全部键名数组
const keysArray = Object.keys(rawObj);
// 输出: ['apple', 'banana', 'orange']
// 方案 B: 获取全部数值数组
const valuesArray = Object.values(rawObj);
// 输出: [10, 25, 18]
// 方案 C: 获取键值对二维数组
const entriesArray = Object.entries(rawObj);
// 输出: [['apple', 10], ['banana', 25], ['orange', 18]]
2. 类数组对象(Array-like Object)转换
类数组对象具有连续的数字键名并带有 length 字段(例如部分老接口或序列化集合):
const arrayLikeJson = '{"0": "北京", "1": "上海", "2": "广州", "length": 3}';
const rawObj = JSON.parse(arrayLikeJson);
// 使用 Array.from 转换为真正的标准数组
const cities = Array.from(rawObj);
console.log(cities); // 输出: ['北京', '上海', '广州']
console.log(Array.isArray(cities)); // true
3. 提取深层嵌套的响应体数组
实际 API 通常会将列表包裹在响应外壳中(如 {"code": 200, "data": { "list": [...] }}):
const responseJson = '{"code": 200, "data": {"list": ["itemA", "itemB"]}}';
function extractList(jsonStr) {
try {
const res = JSON.parse(jsonStr);
// 结合可选链操作符与空值合并
const list = res?.data?.list;
return Array.isArray(list) ? list : [];
} catch {
return [];
}
}
console.log(extractList(responseJson)); // 输出: ['itemA', 'itemB']
四、常见报错与语法规范排查
当执行 JSON.parse() 发生崩溃时,控制台通常会输出 SyntaxError: Unexpected token ... in JSON at position ...。由于 JSON 语法比宽松的 JavaScript 语言要求苛刻得多,掌握以下 4 种典型陷阱即可快速定位问题根源。
| 错误表现 | 错误代码示例 | 标准合规写法 | 发生原因与排查技巧 |
|---|---|---|---|
| 单引号包裹项 | "['A', 'B']" |
'["A", "B"]' |
JSON 规范 RFC 8259 明确规定字符项必须使用双引号。检查前后端拼接逻辑。 |
| 末尾尾随逗号 | '[1, 2, 3, ]' |
'[1, 2, 3]' |
JS 数组字面量支持尾逗号,但 JSON 标准严禁元素后存在孤立逗号。 |
| 非法 JS 字面量 | '[undefined, NaN]' |
'[null, null]' |
JSON 没有 undefined、NaN 和函数。空缺值必须转为 null。 |
| 双重序列化 | '"["A", "B"]"' |
'["A", "B"]' |
数据被 JSON.stringify 连续调用了两次,导致最外层仍然是一个带反斜杠的普通字符串。 |
双重序列化字符串的特殊排查:
如果你发现解析后 typeof result === 'string',说明发生了二次转义。例如后端在将数据放入 Redis 或消息队列前序列化了一次,给前端返回时整个框架又再次序列化了一次。应对代码:
const doubleSerialized = '"[\"Vue\", \"React\"]"';
// 第一次 parse 得到字符串:'["Vue", "React"]'
let step1 = JSON.parse(doubleSerialized);
// 判断若仍是 string,进行二次 parse 得到真数组
let finalArray = typeof step1 === 'string' ? JSON.parse(step1) : step1;
console.log(Array.isArray(finalArray)); // true
console.log(finalArray); // ['Vue', 'React']
五、高级进阶:reviver 转换器与大数精度处理
1. 使用 reviver 参数在转换时清洗数据
JSON.parse(text, reviver) 支持传入第二个参数 reviver 函数。在由字符串还原为数组的过程中,可以同步完成元素类型转换(例如还原 Date 对象):
const timelineJson = '["2026-01-01T00:00:00Z", "2026-12-31T23:59:59Z"]';
// 转换数组的同时直接将时间字符串实例化为 Date 对象
const dateArray = JSON.parse(timelineJson, (key, value) => {
if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(value)) {
return new Date(value);
}
return value;
});
console.log(dateArray[0] instanceof Date); // true
console.log(dateArray[0].getFullYear()); // 2026
2. 超过 53 位的雪花 ID 大整数精度丢失预防
JavaScript 的 Number 类型遵循 IEEE 754 双精度浮点标准,能安全表示的最大整数为 Number.MAX_SAFE_INTEGER(即 2 的 53 次方减 1,等于 9007199254740991,约为 16 位数字)。如果 JSON 数组中含有 19 位以上的数据库自增主键或雪花算法 ID(例如 [1827364556473829102, 1827364556473829103]),直接 JSON.parse() 会发生低位精度丢失,解析出的数字将变成错误数值。
- 首选方案:推动后端将大整数以字符串格式下发(如
["1827364556473829102", ...])。 - 前端独立解析方案:若接口无法变更,在执行解析前引入第三方类库(如
json-bigint)或通过正则将长数字转换为字符串包裹后再进行反序列化。
六、全场景决策树与总结
在前端与 Node.js 开发中,面对各种来源的待处理字符串,可以参照以下场景决策树快速选择最合理的转换与校验方式:
- 核心调用:将 JSON 数组文本还原为 JavaScript 数组的最底线原生方法为
JSON.parse()。 - 防御铁律:严防未知输入的恶意或损坏格式,必须以
try...catch沙箱保护;解析后切忌默认认定为数组,必须使用Array.isArray()确认类型。 - 对象提取:面对非
[...]包裹的键值对象 JSON,通过Object.values()组合提取属性数组。 - 排错核心:发生
SyntaxError时,重点排查是否存在单引号、末尾悬挂逗号以及双重序列化问题。
JS对象数组按指定属性升序或降序排序
2026-11-21 12:19:39
JS闭包实战:手写防抖与节流函数详解
2026-11-21 08:32:58
怎么高效阅读JavaScript高级程序设计并配合代码实践
2026-11-20 22:56:05
JS怎么实现忽略大小写的字符串相等比较
2026-11-20 22:21:36
JS中Object.create()怎么基于原型创建对象
2026-11-20 21:03:28








