TypeScript中的XML处理与解析：库与实用示例

在TypeScript中处理XML：从解析到生成

XML（可扩展标记语言）仍然是数据交换、配置文件和工作流文档的关键格式之一。在TypeScript生态系统中，有多个强大的库可以高效地处理XML，同时保持严格的类型化和静态分析的优势。在本文中，我们将介绍主要工具、它们的功能，并提供实际使用示例。

为什么应该使用TypeScript处理XML？

TypeScript为JavaScript增加了类型系统，这在处理结构复杂的XML文档时特别有用。您可以通过接口描述数据模式，避免访问嵌套元素时出错，并在IDE中自动获得自动补全功能。此外，现代XML处理库都包含类型声明（类型化），使它们的使用更加安全。

TypeScript中处理XML的主要库

• fast-xml-parser — 最快且功能最丰富的库。支持解析为对象/数组、验证、处理属性、CDATA和命名空间。
• xml2js — 经典的解析器，将XML转换为JavaScript对象。支持异步解析和自定义选项。
• xmldom — 适用于Node.js和浏览器的DOM解析器实现。允许像在浏览器DOM中一样操作XML树。
• xmlbuilder2 — 现代库，用于通过链式API创建XML文档，并完全支持类型。

安装库

首先，通过npm安装其中一个库。它们都内置了类型声明：

npm install fast-xml-parsernpm install xml2jsnpm install @xmldom/xmldomnpm install xmlbuilder2

示例1：使用fast-xml-parser解析XML

让我们看一个将XML字符串解析为类型化对象的基本示例：

import { XMLParser } from 'fast-xml-parser';

interface Book {  title: string;  author: string;  year: number;  price?: number;}

interface Catalog {  catalog: {    book: Book | Book[];  };}

const xmlData = `  <catalog>    <book>      <title>TypeScript Handbook</title>      <author>Microsoft</author>      <year>2023</year>    </book>    <book>      <title>XML for Developers</title>      <author>John Doe</author>      <year>2022</year>      <price>29.99</price>    </book>  </catalog>`;

const parser = new XMLParser({  ignoreAttributes: false,  attributeNamePrefix: '@_',  isArray: (name) => name === 'book',});

const result: Catalog = parser.parse(xmlData);console.log(result.catalog.book[0].title); // "TypeScript Handbook"

请注意isArray选项——它确保book元素始终是一个数组，即使XML中只有一本书。这简化了后续处理。

示例2：使用xmlbuilder2创建XML

xmlbuilder2库提供了一个方便的链式接口来生成XML：

import { create } from 'xmlbuilder2';

interface User {  id: number;  name: string;  email: string;}

const user: User = {  id: 42,  name: 'Alice',  email: 'alice@example.com'};

const doc = create({ version: '1.0', encoding: 'UTF-8' })  .ele('users')    .ele('user', { id: user.id.toString() })      .ele('name').txt(user.name).up()      .ele('email').txt(user.email).up()    .up()  .up();

const xmlString: string = doc.end({ prettyPrint: true });console.log(xmlString);/*<?xml version="1.0" encoding="UTF-8"?><users>  <user id="42">    <name>Alice</name>