Fast-XML-Parser 中空标签自动转换为自闭合标签的配置技巧

在 XML 处理过程中，标签的闭合形式是一个值得关注的细节。Fast-XML-Parser 作为一款高效的 XML 处理工具，提供了灵活的配置选项来处理空标签的转换问题。

空标签与自闭合标签的区别

XML 规范中，空标签可以有两种表示形式：

1. 显式闭合形式：<tag></tag>
2. 自闭合形式：<tag/>

虽然这两种形式在语义上是等价的，但在某些特定场景下（如处理 Office 文档时），部分软件对标签形式有严格要求，只接受自闭合形式的空标签。

Fast-XML-Parser 的解决方案

Fast-XML-Parser 提供了一个名为 suppressEmptyNode 的配置选项，专门用于控制空标签的输出形式。当启用此选项时，解析器会自动将空内容节点转换为自闭合标签。

配置示例

const { XMLBuilder } = require('fast-xml-parser');

const jsonObj = {
  a: {
    b: "hello",
    c: "" // 空内容节点
  }
};

const options = {
  suppressEmptyNode: true // 启用空节点压缩
};

const builder = new XMLBuilder(options);
console.log(builder.build(jsonObj));

输出结果

启用 suppressEmptyNode 后，上述代码将输出：

<a>
  <b>hello</b>
  <c/>
</a>

实际应用场景

1. 文档处理：在处理 Office Open XML (OOXML) 等文档格式时，保持标签形式的一致性非常重要。
2. 数据交换：某些 XML 解析器对标签形式有严格要求，使用自闭合标签可以确保更好的兼容性。
3. 文件优化：自闭合标签可以减少文件大小，特别是在处理大量空节点时。

注意事项

1. 此选项只影响真正为空的节点，包含空白字符的节点不会被转换。
2. 如果需要强制某些标签始终以自闭合形式出现（无论内容如何），仍需使用 unpairedTags 配置。
3. 在混合内容模型中应谨慎使用此选项，以免破坏文档结构。

通过合理配置 suppressEmptyNode 选项，开发者可以轻松控制 XML 输出的格式，满足各种应用场景的需求。