JS怎么将JSON格式字符串转换为数组

作者:半夏时间:2026-11-21 11:58:33浏览:87

详细讲解在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)); // 输出: ['张三', '李四']
注意单双引号的区别:在 JavaScript 源码中,声明字符串字面量可以使用单引号或反引号包裹外层,但字符串内部的 JSON 元素必须是双引号。例如 '["apple", "banana"]' 是合法 JSON;而 "['apple', 'banana']" 会直接触发解析语法错误。

二、标准操作步骤与防御式执行流程

在真实的业务链路中,外部传入的 JSON 字符串可能因网络截断、接口异常或人为输入而产生畸变。如果直接裸调 JSON.parse(),一旦字符串语法不合规,浏览器将抛出致命的 SyntaxError 并且中断当前线程运行。因此,标准的操作必须遵循严密的防御流程。

JS怎么将JSON格式字符串转换为数组
图 1:JSON 字符串转换为数组的 5 步标准操作与防御性执行流程

操作步骤拆解:

  1. 步骤 1(入参有效性判定):校验入参是否为 string 类型,并调用 trim() 排除 null、undefined 或纯空白字符串。
  2. 步骤 2(建立防崩沙箱):将核心解析语句装入 try...catch 块中,严防语法错误击溃调用链路。
  3. 步骤 3(核心原生解析):使用底层 C++ 编写的 JSON.parse() 极速反序列化。
  4. 步骤 4(类型断言校验):利用 Array.isArray(result) 判定结果。因为诸如 '{}'、'123'、'null' 等合法 JSON 字符串均不会被 JSON.parse 报错,但它们并非数组!
  5. 步骤 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 为键的字典对象,或是带有数字索引的“类数组对象”。针对不同拓扑形态,需配合不同的内置方法。

JS怎么将JSON格式字符串转换为数组
图 2:不同形态 JSON 字符串转为数组的技术路径映射关系

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 种典型陷阱即可快速定位问题根源。

JS怎么将JSON格式字符串转换为数组
图 3:JSON 字符串语法规范排查矩阵与常见 SyntaxError 修复指南
错误表现 错误代码示例 标准合规写法 发生原因与排查技巧
单引号包裹项 "['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 开发中,面对各种来源的待处理字符串,可以参照以下场景决策树快速选择最合理的转换与校验方式:

JS怎么将JSON格式字符串转换为数组
图 4:JSON 字符串转数组场景决策树与生产环境最佳实践检查清单
核心要点备忘:
  1. 核心调用:将 JSON 数组文本还原为 JavaScript 数组的最底线原生方法为 JSON.parse()。
  2. 防御铁律:严防未知输入的恶意或损坏格式,必须以 try...catch 沙箱保护;解析后切忌默认认定为数组,必须使用 Array.isArray() 确认类型。
  3. 对象提取:面对非 [...] 包裹的键值对象 JSON,通过 Object.values() 组合提取属性数组。
  4. 排错核心:发生 SyntaxError 时,重点排查是否存在单引号、末尾悬挂逗号以及双重序列化问题。
作者最新文章
相关文章
更多