0

0

Node.js中xml2js库的使用:XML与JS对象互转

星降

星降

发布时间:2026-02-07 12:25:02

|

697人浏览过

|

来源于php中文网

原创

xml2js.parseString() 返回 undefined 是因它是异步 API,必须传回调函数;同步解析应使用 parseStringPromise() 或 Parser 实例配合 Promise 封装。

node.js中xml2js库的使用:xml与js对象互转

xml2js.parseString() 解析 XML 字符串时为什么返回 undefined?

常见原因是没传回调函数xml2js.parseString() 是异步 API,不支持直接 return。同步解析要用 xml2js.parseStringPromise()(v0.5+)或改用 new xml2js.Parser().parseString() 配合 Promise 封装。

  • 错误写法:
    const result = xml2js.parseString(xml); // result 是 undefined
  • 正确写法(推荐 Promise 版):
    xml2js.parseStringPromise(xml)
      .then(obj => console.log(obj))
      .catch(err => console.error(err));
  • 若需同步行为(仅限可信、小体积 XML),可用 DOMParser + 自定义转换,但 xml2js 本身无真正同步解析入口

如何控制 parseString 的输出结构(比如去掉 $、_ 等属性)?

xml2js 默认把 XML 属性存为 $,文本内容存为 _,容易干扰后续处理。通过 options 关键参数可简化结构:

  • attrkey: '_' → 把属性统一挂到 _ 下(默认是 $
  • charkey: '#' → 把文本内容挂到 # 下(默认是 _
  • ignoreAttrs: true → 完全忽略属性(最常用)
  • explicitArray: false → 单个子元素不包装成数组(避免 [{…}]
  • 示例:
    const parser = new xml2js.Parser({
      ignoreAttrs: true,
      explicitArray: false,
      trim: true
    });
    parser.parseString(xml, (err, result) => { /* result 中无 $ 和 _ */ });

xml2js.Builder() 生成 XML 时中文乱码或缺少 XML 声明?

默认生成的 XML 是 UTF-8 编码字符串,但不带 声明,且若原始 JS 对象含非 ASCII 字符,需确保运行环境支持 UTF-8 输出(如 Node.js 终端、文件写入时指定编码)。

Android数据格式解析对象JSON用法 WORD版
Android数据格式解析对象JSON用法 WORD版

本文档主要讲述的是Android数据格式解析对象JSON用法;JSON可以将Java对象转成json格式的字符串,可以将json字符串转换成Java。比XML更轻量级,Json使用起来比较轻便和简单。JSON数据格式,在Android中被广泛运用于客户端和服务器通信,在网络数据传输与解析时非常方便。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看

下载
  • 添加声明:传入 rootNamexmldec 选项
    const builder = new xml2js.Builder({
      xmldec: { version: '1.0', encoding: 'UTF-8', standalone: true },
      rootName: 'root'
    });
    const xml = builder.buildObject(obj); // 此时开头会有 
  • 写入文件时务必用 fs.writeFileSync(path, xml, 'utf8'),否则 Windows 记事本可能误判编码
  • 避免在对象字段中混用 Buffer / Stream —— xml2js.Builder 只接受 plain object / array / string / number / boolean

与 xml-js、fast-xml-parser 等库对比,什么场景该坚持用 xml2js?

xml2js 优势不在性能,而在对复杂 XML(含混合内容、命名空间、DOCTYPE、CDATA)的兼容性,以及成熟稳定的回调/Promise 接口设计。如果项目已依赖它处理带 xmlns 的 SOAP 或 RSS,贸然切换反而易出错。

  • 适合:SOAP 响应解析、遗留系统 XML 集成、需要保留注释或 CDATA 的场景
  • 不适合:大文件流式解析(用 sax)、纯性能敏感场景(用 fast-xml-parser)、需严格 XSD 校验(需额外加 libxmljs
  • 注意:xml2js v0.4.x 不支持 ESM,v0.5+ 才有 parseStringPromise;升级后需检查 BuilderrenderOpts 是否被重命名(已改为 xmldec 等)

实际用的时候,最常踩的坑不是语法,而是忘了 ignoreAttrs: true 导致对象里突然冒出一堆 $ 字段,或者没配 explicitArray: false,结果取 obj.items.name 报错——因为它是 obj.items[0].name。这些细节不试一次根本记不住。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

606

2023.08.02

java中boolean的用法
java中boolean的用法

在Java中,boolean是一种基本数据类型,它只有两个可能的值:true和false。boolean类型经常用于条件测试,比如进行比较或者检查某个条件是否满足。想了解更多java中boolean的相关内容,可以阅读本专题下面的文章。

354

2023.11.13

java boolean类型
java boolean类型

本专题整合了java中boolean类型相关教程,阅读专题下面的文章了解更多详细内容。

34

2025.11.30

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1915

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2098

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1104

2024.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

424

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

213

2023.09.04

Golang处理数据库错误教程合集
Golang处理数据库错误教程合集

本专题整合了Golang数据库错误处理方法、技巧、管理策略相关内容,阅读专题下面的文章了解更多详细内容。

2

2026.02.06

热门下载

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

精品课程

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

共101课时 | 8.9万人学习

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

共39课时 | 3.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号