Node.js における XML 処理ライブラリの選定と実装比較

JavaScript で XML を扱う場合、目的が「解析（Parsing）」なのか「生成（Building）」なのか、そして実行環境が「ブラウザ」なのか「Node.js」なのかによって、選ぶべきライブラリが明確に分かれます。fast-xml-parser、libxmljs、xml2js、xmlbuilder、xmlbuilder2 はそれぞれ異なるアプローチを取っており、一長一短があります。本稿では、実務で直面する技術的なトレードオフに焦点を当て、各ライブラリの特性を比較します。

🚀 解析エンジン：純粋な JS vs ネイティブバインディング

XML 解析の速度と環境依存性は、ライブラリ選びの最大の分岐点です。

fast-xml-parser は、純粋な JavaScript（TypeScript）で実装されています。

• 外部のネイティブライブラリに依存しないため、インストールが簡単です。
• Webpack や Vite でのバンドルも容易で、ブラウザ環境でもそのまま動作します。
• 解析速度が非常に速く、バリデーション機能もオプションで利用可能です。

// fast-xml-parser: 純粋な JS で高速解析
const { XMLParser } = require("fast-xml-parser");

const parser = new XMLParser();
const result = parser.parse("<root><item id='1'>Text</item></root>");

console.log(result); 
// { root: { item: { '#text': 'Text', '@_id': '1' } } }

libxmljs は、C 言語で書かれた高性能ライブラリ libxml2 のラッパーです。

• 解析速度は圧倒的に高速で、巨大な XML ファイルを扱う場合に有利です。
• XPath クエリや XML スキーマ検証など、高機能な操作が可能です。
• 一方で、node-gyp によるネイティブコンパイルが必要であり、ビルド環境がないサーバーレス環境や Windows 環境ではトラブルになりやすいです。

// libxmljs: ネイティブバインディングによる高速処理
const libxml = require("libxmljs");

const xmlDoc = libxml.parseXmlString("<root><item id='1'>Text</item></root>");
const item = xmlDoc.get("//item");

console.log(item.text()); // "Text"
console.log(item.attr("id").value()); // "1"

xml2js は、長年使われている純粋な JavaScript ライブラリです。

• 安定性が高く、多くの既存プロジェクトで採用されています。
• fast-xml-parser に比べると解析速度は劣りますが、機能は十分です。
• 非同期 API（Promise/Callback）を提供しており、大きなファイルのストリーム処理にも対応しています。

// xml2js: 安定した非同期解析
const { parseStringPromise } = require("xml2js");

const xml = "<root><item id='1'>Text</item></root>";

async function parse() {
  const result = await parseStringPromise(xml);
  console.log(result);
  // { root: { item: [ { $: { id: '1' }, _: 'Text' } ] } }
}

🏗️ XML 生成：レガシー vs モダンなチェーン操作

XML を構築する際、コードの可読性とメンテナンス性は重要です。

xmlbuilder は、長らく標準として使われてきましたが、現在はメンテナンスモードに入っています。

• 単純なチェーン操作で XML を生成できます。
• 新規プロジェクトでは使用を避け、後継の xmlbuilder2 への移行を検討すべきです。

// xmlbuilder: 従来のチェーン操作（レガシー）
const builder = require("xmlbuilder");

const xml = builder.create("root")
  .ele("item", { id: "1" })
  .txt("Text")
  .end({ pretty: true });

console.log(xml);

xmlbuilder2 は、xmlbuilder の問題点を解消するために書き直されたモダンなライブラリです。

• ES6 モジュールに対応し、より直感的な API 設計になっています。
• XML 生成だけでなく、オブジェクトからの変換（convert）機能も強化されています。
• 型安全性（TypeScript）のサポートも改善されています。

// xmlbuilder2: モダンな API と変換機能
const { create } = require("xmlbuilder2");

const doc = create({ encoding: "UTF-8" })
  .ele("root")
    .ele("item", { id: "1" }).txt("Text")
  .up()
  .end({ prettyPrint: true });

console.log(doc);

🛡️ 検証とセキュリティ：バリデーション機能の有無

外部から受け取る XML データを扱う場合、セキュリティと形式の検証が不可欠です。

fast-xml-parser は、解析と同時にバリデーションを行うオプションを提供します。

• 設定一つで、無効な XML 構造を検出できます。
• XXE（XML External Entity）攻撃などのセキュリティリスクに対する対策オプションも用意されています。

// fast-xml-parser: 内蔵バリデーション
const { XMLParser, XMLValidator } = require("fast-xml-parser");

const validation = XMLValidator.validate(xmlString);
if (validation === true) {
  const parser = new XMLParser();
  const result = parser.parse(xmlString);
}

libxmljs は、XSD（XML Schema Definition）による厳密な検証が可能です。

• 業務システムなど、データ形式の厳格な管理が必要な場合に強力です。
• 純粋な JS ライブラリでは実現困難なレベルの検証を行えます。

// libxmljs: XSD によるスキーマ検証
const libxml = require("libxmljs");

const xsd = libxml.parseXmlString(xsdSchemaString);
const xml = libxml.parseXmlString(xmlString);

const isValid = xml.validate(xsd);
console.log(isValid); // true or false

xml2js には、標準では厳密なバリデーション機能は含まれていません。

• 解析エラーは検出しますが、ビジネスロジックに基づく形式検証は別途実装する必要があります。
• 単純なデータ変換が目的であれば十分ですが、セキュリティ重視の場面では注意が必要です。

// xml2js: 基本的なエラーハンドリング
const { parseStringPromise } = require("xml2js");

parseStringPromise(xmlString)
  .then(result => { /* 成功 */ })
  .catch(err => { /* 構文エラーなどをキャッチ */ });

🌐 環境互換性：どこで動かすか

実行環境によって、選択肢が狭まることがあります。

• fast-xml-parser: 依存関係が少なく純粋な JS なので、ブラウザ、Node.js、Cloudflare Workers など、あらゆる環境で動作します。フロントエンドで XML を扱うなら第一候補です。
• libxmljs: Node.js のみです。ネイティブコードを含むため、ブラウザでは動作せず、サーバーレス環境でもコンパイル済みバイナリの提供がない限り使用できません。
• xml2js / xmlbuilder / xmlbuilder2: 純粋な JS なので、ブラウザと Node.js の両方で動作します。ただし、xmlbuilder は古い設計のため、モダンなビルドツールとの相性で警告が出ることがあります。

📊 実装パターンの違い：同期 vs 非同期

処理のフロー設計にも影響します。

• fast-xml-parser: 基本的に同期処理です。シンプルで制御しやすいですが、超大規模なデータを扱う際はイベントループをブロックする可能性があります。
• xml2js: 非同期処理（Promise/Callback）が基本です。大きなファイルのストリーム処理に適しており、サーバーのレスポンスを阻害しにくい設計です。
• libxmljs: 基本的に同期処理ですが、高速なネイティブコードなので、JS 製のものよりブロックの影響は小さい傾向にあります。

// xml2js: ストリーム処理の例（非同期）
const { parseString } = require("xml2js");
const fs = require("fs");

const stream = fs.createReadStream("large-file.xml");
const parser = new require("xml2js").Parser();

parser.parseStream(stream, (err, result) => {
  // 完了時にコールバック
});

💡 選定のガイドライン

🏁 結論：現代的な選択とは

fast-xml-parser は、純粋な JavaScript で動作しながらも libxmljs に匹敵する速度を出せるため、多くのケースで最適な選択となります。特に、コンパイルの手間を避けたい、あるいはブラウザでも動かしたい場合には、これ一択と言えるでしょう。

libxmljs は、サーバーサイドで巨大な XML を処理し、かつ XSD 検証などの高度な機能が必要な場合にのみ検討します。導入コスト（ビルド環境）に見合うメリットがある場面は限られています。

xmlbuilder2 は、XML 生成が必要な場合の現代的な標準です。古い xmlbuilder を使っているプロジェクトは、技術的負債を減らすために移行を検討する価値があります。

xml2js は、まだ現役で使われていますが、新規プロジェクトでは fast-xml-parser の方がパフォーマンスと機能面で優れていることが多いです。

XML 処理は地味なタスクに見えますが、ライブラリの選択がセキュリティやパフォーマンスに直結します。プロジェクトの環境と要件に合わせて、適切なツールを選びましょう。