萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 解析 XML 完整指南:DOMParser、跨瀏覽器相容、錯誤處理與現代替代方案

雖然 JSON 已成主流,但許多企業系統、RSS、SVG、Office Open XML、地圖資料(GPX/KML)仍大量使用 XML。本文提供瀏覽器原生 DOMParser、Node.js 環境、錯誤處理、命名空間、XPath 查詢、大型 XML 流式解析的完整方案。

瀏覽器環境:DOMParser(標準、現代、推薦)


/**
 * 解析 XML 字串為 Document 物件
 * @param {string} xmlString
 * @returns {Document}
 * @throws {Error} 解析錯誤時拋出(包含 parsererror 節點)
 */
function parseXML(xmlString) {
  const parser = new DOMParser();
  const doc = parser.parseFromString(xmlString, 'application/xml');
  
  // 檢查解析錯誤
  const errorNode = doc.querySelector('parsererror');
  if (errorNode) {
    throw new Error(`XML 解析失敗: ${errorNode.textContent}`);
  }
  return doc;
}

// 使用範例
const xml = `

  台積電192.168.1.1
  聯發科192.168.1.2
`;

const doc = parseXML(xml);
const companies = doc.querySelectorAll('Company');
companies.forEach(el => {
  const name = el.querySelector('cNname')?.textContent;
  const ip = el.querySelector('cIP')?.textContent;
  console.log(`${name}: ${ip}`);
});

Node.js 環境:xmldom / @xmldom/xmldom


// npm install @xmldom/xmldom
const { DOMParser } = require('@xmldom/xmldom');
// 或舊版:const { DOMParser } = require('xmldom');

const doc = new DOMParser().parseFromString(xmlString, 'application/xml');
// 後續操作同瀏覽器

跨瀏覽器舊版相容(IE9 以下,僅供維護舊專案參考)


function loadXMLLegacy(xmlString) {
  let doc;
  if (window.DOMParser) { // 現代瀏覽器
    doc = new DOMParser().parseFromString(xmlString, 'application/xml');
  } else if (window.ActiveXObject) { // IE6-8
    const versions = ['MSXML2.DOMDocument.6.0', 'MSXML2.DOMDocument.3.0', 'Microsoft.XMLDOM'];
    for (const v of versions) {
      try {
        doc = new ActiveXObject(v);
        doc.async = false;
        doc.loadXML(xmlString);
        break;
      } catch { /* try next */ }
    }
  }
  if (!doc) throw new Error('無法建立 XML DOM');
  
  // IE 解析錯誤檢查
  if (doc.parseError && doc.parseError.errorCode !== 0) {
    throw new Error(`XML 解析錯誤 ${doc.parseError.line}: ${doc.parseError.reason}`);
  }
  return doc;
}

進階查詢技巧

1. XPath 查詢(強大、標準、跨語言)


// 瀏覽器
function xpathSelect(doc, expression, contextNode = doc) {
  const result = doc.evaluate(expression, contextNode, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
  const nodes = [];
  for (let i = 0; i < result.snapshotLength; i++) {
    nodes.push(result.snapshotItem(i));
  }
  return nodes;
}

// Node.js (需安裝 xpath)
const xpath = require('xpath');
const nodes = xpath.select('//Company/cNname', doc);

// 範例
const names = xpathSelect(doc, '//Company/cNname/text()');
names.forEach(n => console.log(n.nodeValue));

2. 命名空間處理


const nsXml = `

  A
  B
`;

const doc = parseXML(nsXml);

// 瀏覽器:建立 NamespaceResolver
const resolver = {
  lookupNamespaceURI: (prefix) => {
    const map = { foo: 'https://example.com/foo', bar: 'https://example.com/bar' };
    return map[prefix] || null;
  }
};
const items = xpathSelect(doc, '//foo:item | //bar:item', doc, resolver);

// Node.js (xpath + xmldom)
const { DOMParser } = require('@xmldom/xmldom');
const xpath = require('xpath');
const doc2 = new DOMParser().parseFromString(nsXml, 'application/xml');
const nodes = xpath.select('//*[local-name()="item"]', doc2); // 忽略命名空間
// 或註冊命名空間
xpath.useNamespaces({ foo: 'https://example.com/foo', bar: 'https://example.com/bar' });
const fooItems = xpath.select('//foo:item', doc2);

3. XML 序列化回字串


// 瀏覽器
const serializer = new XMLSerializer();
const xmlStr = serializer.serializeToString(doc);

// Node.js (xmldom 內建 toString)
console.log(doc.toString()); // 含宣告
// 或
const serializer2 = require('@xmldom/xmldom').XMLSerializer;
console.log(new serializer2().serializeToString(doc));

大型 XML 流式解析(避免記憶體爆炸)

當 XML > 50MB 時,DOM 解析會佔用大量記憶體,需改用 SAX 流式解析:

Node.js: sax / fast-xml-parser


// npm install sax
const sax = require('sax');
const fs = require('fs');

const parser = sax.createStream(true, { trim: true, lowercase: true });
parser.on('opentag', node => {
  if (node.name === 'company') {
    console.log('Found company:', node.attributes);
  }
});
parser.on('text', text => { /* 累積文字內容 */ });
parser.on('closetag', name => { /* 結束元素處理 */ });
parser.on('error', e => { console.error(e); parser._parser.error = null; });

fs.createReadStream('huge.xml').pipe(parser);

瀏覽器: 使用 FileReader + SAX (如 sax.js) 或分塊處理


// 簡易分塊:適合結構固定、可按行分割的 XML
async function parseLargeXMLChunked(file) {
  const stream = file.stream();
  const reader = stream.getReader();
  const decoder = new TextDecoder();
  let buffer = '';
  
  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    buffer += decoder.decode(value, { stream: true });
    
    // 簡易行分割處理(需根據實際 XML 結構調整)
    const lines = buffer.split('\n');
    buffer = lines.pop(); // 保留不完整行
    
    for (const line of lines) {
      if (line.includes('')) { /* 開始新記錄 */ }
      if (line.includes('')) { /* 完成一筆,送入處理佇列 */ }
    }
  }
  // 處理剩餘 buffer
}

常見錯誤與除錯

錯誤原因解決
parsererror: "Premature end of data"XML 截斷、未正確閉合檢查來源完整性、補全標籤
Namespace prefix not declaredXPath 查詢未註冊命名空間使用 NamespaceResolver 或 local-name()
document.querySelector 回傳 null大小寫不符(XML 區分大小寫)確認標籤大小寫、使用 getElementsByTagNameNS
特殊字元導致解析失敗未轉義 < > & ' "來源端需正確 CDATA 或實體編碼
記憶體不足 (OOM)巨大 XML 載入 DOM改用 SAX 流式解析

現代替代方案:轉 JSON 再處理


// fast-xml-parser (Node/Browser, 0 依賴, 快速)
const { XMLParser } = require('fast-xml-parser');
const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: '@_' });
const json = parser.parse(xmlString);
// json = { DongFang: { Company: [ { cNname: '台積電', cIP: '192.168.1.1' }, ... ] } }

// 直接用 JSON 路徑查詢、轉換、驗證

結語

現代前端解析 XML 首選 DOMParser + XPath,Node.js 用 @xmldom/xmldom + xpath 或 fast-xml-parser 轉 JSON。大檔案必須用 SAX 流式解析。命名空間處理是最易踩坑處,建議統一封裝 parseXML、xpathSelect、serializeXML 三大核心函數,專案內強制使用,避免散落各處的相容代碼造成維護災難。

copyright © 萬盛學電腦網 all rights reserved