JavaScript解析嵌套JSON后,如何转成扁平字段并保留数组结构?

发布人:A5数据发布时间:2026-11-16 13:10阅读量:14

解析嵌套 JSON 时,可以先用 JSON.parse() 得到 JavaScript 数据,再递归展开普通对象的层级,把路径合并成字段名;遇到数组则保留数组,不把元素改成带下标的字段。这样,user.profile.name 会成为一个扁平字段,而 orders 仍是数组,数组内对象的字段也会在各自元素中展开。

下面实现会保留数组的长度、顺序和嵌套层级,也会保留 null、空数组和空对象。路径使用点号连接;如果原始字段名含有点号或反斜杠,会先转义,避免不同路径合并成同一个字段名。

先确定扁平化后的数据结构

扁平化时,“数组仍然是数组”和“数组元素也变成扁平字段”可以同时做到。例如,输入中的 orders 是一个数组,输出仍然是 orders 数组,但其中每个对象的 product.name 会在该元素内部展开。

输入结构输出结构处理方式
user.profile.nameuser.profile.name 字段普通对象逐层展开
tags: ["js", "json"]tags: ["js", "json"]保留原数组
orders: [{product: {name: "键盘"}}]orders: [{ "product.name": "键盘" }]保留数组,对数组中的对象分别展开
empty: {}empty: {}保留空对象,避免数据丢失
value: nullvalue: null保留 null

这里的路径键只是普通字符串,并不是 JavaScript 对象的层级访问语法。比如,结果中的 "user.profile.name" 是一个键名;读取时应使用 result["user.profile.name"],而不是 result.user.profile.name。

编写解析与扁平化函数

以下代码不依赖第三方库,可在浏览器或 Node.js 中使用。它把普通对象展开成扁平字段;数组本身保持数组结构,并递归处理数组里的对象和子数组。

function isJsonObject(value) {
  return value !== null &&
    typeof value === "object" &&
    !Array.isArray(value);
}

function escapePathSegment(segment) {
  return String(segment)
    .replace(/\\/g, "\\\\")
    .replace(/\./g, "\\.");
}

function definePath(target, segments, value) {
  const key = segments.map(escapePathSegment).join(".");

  // 使用 defineProperty,避免 "__proto__" 等字段名被当作特殊属性处理。
  Object.defineProperty(target, key, {
    value,
    enumerable: true,
    writable: true,
    configurable: true
  });
}

function flattenObjectInto(target, source, prefix = []) {
  for (const key of Object.keys(source)) {
    const segments = prefix.concat(key);
    const value = source[key];

    if (isJsonObject(value) && Object.keys(value).length > 0) {
      // 非空对象继续展开到同一个结果对象中。
      flattenObjectInto(target, value, segments);
    } else {
      // 数组、空对象、null 和基本类型作为字段值保留。
      definePath(target, segments, transformValue(value));
    }
  }
}

function flattenObject(source) {
  const result = {};
  flattenObjectInto(result, source);
  return result;
}

function transformValue(value) {
  if (Array.isArray(value)) {
    // 不把数组转成带下标的键;递归处理数组内的值。
    return value.map(transformValue);
  }

  if (isJsonObject(value)) {
    // 对数组元素中的对象,同样展开其内部对象层级。
    return flattenObject(value);
  }

  return value;
}

function parseAndFlatten(jsonText) {
  if (typeof jsonText !== "string") {
    throw new TypeError("jsonText 必须是 JSON 字符串");
  }

  const parsed = JSON.parse(jsonText);
  return transformValue(parsed);
}

JSON.parse() 负责把文本转换为 JavaScript 值,transformValue() 再按值的类型处理数据:对象交给扁平化函数,数组通过 map() 保持数组形态,其他值则原样返回。若输入顶层本身是数组,结果也会是数组;若输入是数字、字符串、布尔值或 null,函数会返回相应的解析结果。

编写解析与扁平化函数配图

用一组数据查看输出

把 JSON 文本传给 parseAndFlatten(),即可获得转换后的对象:

const input = `{
  "user": {
    "id": 42,
    "profile": {
      "name": "林",
      "active": true
    }
  },
  "tags": ["js", "json"],
  "orders": [
    {
      "id": "A-100",
      "product": {
        "name": "键盘"
      },
      "attributes": [
        {
          "key": "颜色",
          "value": "黑色"
        }
      ]
    },
    null,
    {
      "id": "A-101"
    }
  ],
  "matrix": [[1, 2], [3, 4]],
  "empty": {},
  "nullable": null
}`;

const result = parseAndFlatten(input);

console.log(JSON.stringify(result, null, 2));

输出如下:

{
  "user.id": 42,
  "user.profile.name": "林",
  "user.profile.active": true,
  "tags": [
    "js",
    "json"
  ],
  "orders": [
    {
      "id": "A-100",
      "product.name": "键盘",
      "attributes": [
        {
          "key": "颜色",
          "value": "黑色"
        }
      ]
    },
    null,
    {
      "id": "A-101"
    }
  ],
  "matrix": [
    [
      1,
      2
    ],
    [
      3,
      4
    ]
  ],
  "empty": {},
  "nullable": null
}

可以看到,user 下的普通对象层级被展开成带点号的字段;tags 和 matrix 仍然是数组,顺序和嵌套关系未改变。orders 也仍然是数组,第一项里的 product 对象被展开为 "product.name",attributes 则继续保留为数组。数组中的 null 和没有额外嵌套字段的订单对象也都被保留。

读取字段并检查结果

扁平字段包含点号时,应使用方括号和完整键名访问:

console.log(result["user.profile.name"]); // 林
console.log(result["user.id"]);          // 42

console.log(Array.isArray(result.tags));   // true
console.log(result.orders.length);         // 3
console.log(result.orders[0]["product.name"]); // 键盘

可以在开发阶段加上简单断言,确认转换结果满足预期:

console.assert(result["user.profile.name"] === "林");
console.assert(Array.isArray(result.tags));
console.assert(Array.isArray(result.orders));
console.assert(result.orders[1] === null);
console.assert(result.orders[0]["product.name"] === "键盘");

断言失败时,通常可以先分别检查原始 JSON 是否有效、目标字段路径是否正确,以及该字段是否位于数组元素中。数组元素内部的扁平字段要先取出对应元素,再按完整键名读取,例如 result.orders[0]["product.name"]。

字段名中含有点号时的处理

如果原始数据中有一个字段名本身包含点号,直接用点号拼接路径可能产生歧义。例如:

{
  "settings": {
    "ui.theme": "dark"
  }
}

代码会把字段名里的点号转义。扁平结果中的实际键名是 settings.ui\.theme;如果通过 JSON.stringify() 输出,反斜杠还会按 JSON 规则转义显示。反斜杠本身也会先转义,因此字段名里的点号和路径分隔用的点号可以区分。

这类键名适合用作扁平数据传输或展示字段,但如果后续系统要把它重新还原成原始嵌套 JSON,就需要使用同一套路径转义规则解析键名。还原时不要简单地按 . 拆分,否则包含点号的原始字段名会被拆错。

什么时候要把数组元素也展开成带下标的字段

本文代码把数组保留为真正的数组,因此 orders[0].id 不会成为结果对象的键;对应数据位于 result.orders[0].id。另一种常见约定是将数组元素也转成路径,例如 "orders[0].id"。这种格式更接近“所有值都变成路径键”的扁平映射,但数组不再以数组的形式存在,消费端也要按约定解析下标才能还原结构。

两种格式服务于不同的数据契约:

  • 下游需要遍历数组、按顺序渲染列表或保留数组嵌套时,保留数组结构更合适。
  • 下游接口只接收路径键值对,且约定了数组下标格式时,才考虑把下标写入字段名。
  • 同一个接口应固定一种格式。不要在不同字段上临时决定是否保留数组,否则调用方难以判断字段类型。

如果目标是把数据展示在表格中,可以在展示层单独遍历数组;不必为了表格展示而提前破坏数据结构。

JSON 解析失败与使用边界

JSON.parse() 只接受符合 JSON 语法的文本。解析失败时会抛出 SyntaxError,可以在调用处捕获并反馈输入无效:

try {
  const result = parseAndFlatten(input);
  console.log(result);
} catch (error) {
  if (error instanceof SyntaxError) {
    console.error("JSON 格式不正确,请检查引号、逗号和括号。");
  } else {
    throw error;
  }
}

JSON 字符串中的属性名和字符串值必须使用双引号;尾随逗号、注释和未加引号的键名都不是标准 JSON。若数据来源可能返回空字符串或其他非 JSON 内容,应在调用解析函数前按业务规则处理,不要把解析失败的内容当成空对象悄悄继续。

这段实现适用于从 JSON 文本得到的数据。如果输入已经是 JavaScript 对象,不要再传给 JSON.parse();可以直接调用 transformValue()。另外,扁平化会改变普通对象的访问方式,但不会验证业务字段是否齐全,也不会替代数据格式校验。若结果要写入页面,仍应按页面框架的安全方式渲染文本,避免把外部数据直接当作 HTML 插入。

使用这套实现时,先确认下游希望得到的是路径键映射还是保留数组的对象;确定结构后,再用包含普通嵌套对象、数组、空对象和 null 的样例检查结果。这样既能压平需要快速访问的字段,也能保留数组顺序和层级,减少后续调用方对数据结构的误解。

在处理嵌套 JSON 的接口服务和业务后台中,解析与字段转换也常伴随数据库读写、并发请求及数据存储。A5idc数据提供香港、美国、日本等多地区物理服务器,涵盖 Xeon 与 AMD EPYC 平台,并有搭配较大内存和 NVMe 存储的配置,可为接口程序、数据库及多任务后台提供计算与存储资源;不同地区的线路方案也可承载面向相应访问区域的业务部署。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9788.html

相关推荐