XML 到 JSON 转换中正确处理元素属性的完整教程

小敏吖_4696

小敏吖_4696

2026-05-01

914人浏览

原创

本文详解如何在 JavaScript 中实现健壮的 XML→JSON 转换,重点解决属性(如 id)被错误挂载到父级而非所属元素的问题,并提供可直接运行的修复方案。

本文详解如何在 javascript 中实现健壮的 xml→json 转换,重点解决属性(如 `id`)被错误挂载到父级而非所属元素的问题,并提供可直接运行的修复方案。

在将 XML 结构转换为 JSON 时,一个常见但极易被忽视的陷阱是:元素属性未被正确归属到其宿主节点,而是意外“上浮”至父级对象中。原始代码中, 的 id 属性最终出现在顶层 "smf" 对象下,而非每个 topic 子对象内部——这直接违背了语义一致性与下游消费预期。

根本原因在于原始逻辑中属性收集与子节点递归处理的顺序及作用域错位:它先遍历子元素、再在子元素处理过程中(错误地)将属性写入当前层级的 obj,而此时 obj 实际代表的是父节点的返回值,导致属性“越级”写入。

✅ 正确做法是:每个节点的属性必须仅作用于该节点自身生成的对象。修复后的 xml2js 函数严格遵循这一原则:

  1. 优先提取当前节点全部属性,使用现代语法 [...node.attributes || []] 安全展开(兼容无属性情况),并通过 reduce 构建初始对象;
  2. 再处理子节点:对每个子元素递归调用 xml2js(item),并根据同名字段是否存在,自动合并为数组(避免单个元素被覆盖);
  3. 显式区分文本内容与结构内容:当节点无子元素时,将 textContent 统一存入 content 字段(可选,增强可读性;若需纯字符串值,可替换为直接返回 node.textContent)。

以下是生产就绪的修复版实现:

arcgis-js
arcgis-js

提供 ArcGIS Maps SDK for JavaScript 开发辅助,涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。

下载
function xml2js(node) {
  try {
    // ✅ 第一步:安全提取当前节点所有属性,构建基础对象
    const obj = [...(node.attributes || [])].reduce((acc, attr) => {
      acc[attr.nodeName] = attr.value;
      return acc;
    }, {});

    // ✅ 第二步:处理子节点(非文本节点)
    if (node.children && node.children.length > 0) {
      for (const item of node.children) {
        const { nodeName } = item;
        const childResult = xml2js(item);

        if (obj[nodeName] === undefined) {
          // 首次出现:直接赋值
          obj[nodeName] = childResult;
        } else {
          // 多次出现:转为数组并追加
          if (!Array.isArray(obj[nodeName])) {
            obj[nodeName] = [obj[nodeName]];
          }
          obj[nodeName].push(childResult);
        }
      }
    } else if (node.textContent?.trim()) {
      // ✅ 第三步:无子元素但有文本内容 → 存入 content 字段(清晰区分结构与值)
      obj.content = node.textContent.trim();
    }

    return obj;
  } catch (e) {
    console.error('XML to JSON conversion error:', e);
    throw e;
  }
}

// 使用示例
const XMLString = `<?xml version="1.0" encoding="UTF-8"?><smf><lasttime>1694246241</lasttime><topic id="78603"><icon>@@##@@]]></icon><subject>Test #14561]]></subject></topic></smf>`;

const XMLDoc = new DOMParser().parseFromString(XMLString, 'text/xml');
const result = xml2js(XMLDoc.documentElement); // 注意:传入 documentElement 而非整个 Document
console.log(JSON.stringify(result, null, 2));

? 关键注意事项:

  • 始终传入 documentElement:DOMParser.parseFromString() 返回的是 Document 对象,其根元素为 documentElement(即 ),而非 Document 自身 —— 后者包含 doctype、xmlVersion 等元信息,直接传入会导致意外行为。
  • textContent vs innerHTML:本方案使用 textContent 获取纯文本内容(自动解码 CDATA),若需保留 HTML 标签字符串,请确保源 XML 中已正确转义(如
  • 空元素/纯文本节点处理:当前逻辑对 1694246241 正确生成 "lastTime": {"content": "1694246241"};若期望扁平化为 "lastTime": "1694246241",可在无子节点时直接 return node.textContent.trim(),但需权衡与含属性元素(如 )的一致性。
  • 性能提示:对超大 XML,建议添加递归深度限制或使用栈模拟迭代,避免潜在栈溢出。

通过以上重构,id、ts 等所有属性均精准绑定至其所属元素对象内,输出结构严格符合预期,具备良好可维护性与扩展性。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2195

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3442

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1156

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3939

7

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

4536

8

正则表达式不包含
正则表达式不包含

正则表达式,又称规则表达式,,是一种文本模式,包括普通字符和特殊字符,是计算机科学的一个概念。正则表达式使用单个字符串来描述、匹配一系列匹配某个句法规则的字符串,通常被用来检索、替换那些符合某个模式的文本。php中文网给大家带来了有关正则表达式的相关教程以及文章,希望对大家能有所帮助。

2023.07.05

3041

4

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8442

9

java正则表达式匹配字符串
java正则表达式匹配字符串

在Java中,我们可以使用正则表达式来匹配字符串。本专题为大家带来java正则表达式匹配字符串的相关内容,帮助大家解决问题。

2023.08.11

812

5

正则表达式空格
正则表达式空格

正则表达式空格可以用“\s”来表示,它是一个特殊的元字符,用于匹配任意空白字符,包括空格、制表符、换行符等。本专题为大家提供正则表达式相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

520

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习