雖然 JSON 已成主流,但許多企業系統、RSS、SVG、Office Open XML、地圖資料(GPX/KML)仍大量使用 XML。本文提供瀏覽器原生 DOMParser、Node.js 環境、錯誤處理、命名空間、XPath 查詢、大型 XML 流式解析的完整方案。
/**
* 解析 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}`);
});
// npm install @xmldom/xmldom
const { DOMParser } = require('@xmldom/xmldom');
// 或舊版:const { DOMParser } = require('xmldom');
const doc = new DOMParser().parseFromString(xmlString, 'application/xml');
// 後續操作同瀏覽器
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;
}
// 瀏覽器
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));
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);
// 瀏覽器
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 > 50MB 時,DOM 解析會佔用大量記憶體,需改用 SAX 流式解析:
// 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);
// 簡易分塊:適合結構固定、可按行分割的 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 declared | XPath 查詢未註冊命名空間 | 使用 NamespaceResolver 或 local-name() |
| document.querySelector 回傳 null | 大小寫不符(XML 區分大小寫) | 確認標籤大小寫、使用 getElementsByTagNameNS |
| 特殊字元導致解析失敗 | 未轉義 < > & ' " | 來源端需正確 CDATA 或實體編碼 |
| 記憶體不足 (OOM) | 巨大 XML 載入 DOM | 改用 SAX 流式解析 |
// 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 三大核心函數,專案內強制使用,避免散落各處的相容代碼造成維護災難。