萬盛學電腦網

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

JavaScript 跨瀏覽器 XML 解析:兼容 IE/Chrome/Firefox 的完整方案

XML 解析的瀏覽器差異

雖然現代項目多用 JSON,但舊系統、企業級應用、RSS/Atom、SOAP 等場景仍需解析 XML。瀏覽器原生 XML 解析 API 存在差異:

特性IE (ActiveX)現代瀏覽器 (DOMParser/XMLHttpRequest)
創建解析器new ActiveXObject("Microsoft.XMLDOM")new DOMParser() 或 xhr.responseXML
加載方式xmlDom.load(url) (異步/同步)xhr.open + send 或 parser.parseFromString()
查詢節點selectNodes(), selectSingleNode() (XPath)getElementsByTagName(), querySelector()
獲取文本node.textnode.textContent

統一封裝方案:parseXMLDOM 模式

/**
 * 跨瀏覽器 XML 解析器
 * 支持:IE (ActiveX), Chrome, Firefox, Edge, Safari
 */
var XMLParser = (function() {
    var browserType = "";
    var xmlFile = "";
    var xmlDom = null;

    // 瀏覽器檢測
    function detectBrowser() {
        var ua = navigator.userAgent;
        if (ua.indexOf("MSIE") !== -1 || ua.indexOf("Trident") !== -1) return "IE";
        if (ua.indexOf("Chrome") !== -1) return "Chrome";
        if (ua.indexOf("Firefox") !== -1) return "Firefox";
        if (ua.indexOf("Safari") !== -1) return "Safari";
        if (ua.indexOf("Edge") !== -1) return "Edge";
        return "Unknown";
    }

    // 創建 XML DOM
    function createXmlDom(xmlFilePath) {
        var dom;
        if (browserType === "IE") {
            dom = new ActiveXObject("Microsoft.XMLDOM");
            dom.async = false; // 同步加載
            dom.load(xmlFilePath);
        } else {
            // 現代瀏覽器:同步 XHR 獲取 XML 文檔
            var xhr = new XMLHttpRequest();
            xhr.open("GET", xmlFilePath, false); // 同步(演示用,生產建議異步)
            xhr.send(null);
            dom = xhr.responseXML;
            
            // 兼容:responseXML 為 null 時嘗試手動解析
            if (!dom && xhr.responseText) {
                var parser = new DOMParser();
                dom = parser.parseFromString(xhr.responseText, "text/xml");
            }
        }
        return dom;
    }

    // 解析並提取數據
    function parse(xmlDom) {
        var result = [];
        if (!xmlDom) return result;

        var books;
        if (browserType === "IE") {
            // IE 使用 XPath
            books = xmlDom.selectNodes("books/book");
            if (books) {
                for (var i = 0; i < books.length; i++) {
                    var book = books[i];
                    result.push({
                        isbn: book.selectSingleNode("isbn")?.text || "",
                        price: book.selectSingleNode("price")?.text || "",
                        title: book.selectSingleNode("title")?.text || ""
                    });
                }
            }
        } else {
            // 現代瀏覽器使用 DOM API
            books = xmlDom.getElementsByTagName("book");
            for (var i = 0; i < books.length; i++) {
                var book = books[i];
                result.push({
                    isbn: getTextContent(book, "isbn"),
                    price: getTextContent(book, "price"),
                    title: getTextContent(book, "title")
                });
            }
        }
        return result;
    }

    function getTextContent(parent, tagName) {
        var nodes = parent.getElementsByTagName(tagName);
        return nodes.length > 0 ? (nodes[0].textContent || nodes[0].text || "") : "";
    }

    // 公開 API
    return {
        init: function(filePath) {
            browserType = detectBrowser();
            xmlFile = filePath;
            xmlDom = createXmlDom(xmlFile);
            return this;
        },
        getData: function() {
            return parse(xmlDom);
        },
        getBrowser: function() {
            return browserType;
        },
        getDom: function() {
            return xmlDom;
        }
    };
})();

// 使用示例
window.onload = function() {
    XMLParser.init("test.xml");
    var data = XMLParser.getData();
    console.log("解析結果:", data);
    // 渲染到頁面
    var html = data.map(function(item) {
        return item.isbn + " " + item.price + " " + item.title;
    }).join("
"); document.getElementById("msg").innerHTML = html; };

測試 XML 文件 (test.xml)

<?xml version="1.0" encoding="UTF-8"?>
<books>
    <book>
        <isbn>2207-1258-123</isbn>
        <price>25</price>
        <title>Javascript</title>
    </book>
    <book>
        <isbn>2207-1258-456</isbn>
        <price>50</price>
        <title>Ajax</title>
    </book>
    <book>
        <isbn>2207-1258-789</isbn>
        <price>75</price>
        <title>C#</title>
    </book>
</books>

HTML 頁面

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>跨瀏覽器 XML 解析演示</title>
    <script src="xmlparser.js"></script>
</head>
<body>
    <div id="msg">載入中...</div>
</body>
</html>

關鍵兼容性處理詳解

1. 同步 vs 異步加載

演示代碼使用同步 XHR (open(..., false)) 簡化流程,但會阻塞主線程。生產環境建議異步:

function loadXmlAsync(url, callback) {
    var xhr = new XMLHttpRequest();
    xhr.open("GET", url, true);
    xhr.onload = function() {
        if (xhr.status === 200) {
            var dom = xhr.responseXML;
            if (!dom && xhr.responseText) {
                dom = new DOMParser().parseFromString(xhr.responseText, "text/xml");
            }
            callback(null, dom);
        } else {
            callback(new Error("HTTP " + xhr.status));
        }
    };
    xhr.onerror = function() { callback(new Error("Network error")); };
    xhr.send();
}

2. 解析錯誤處理

// 檢查解析錯誤
var parserError = dom.querySelector("parsererror");
if (parserError) {
    console.error("XML 解析錯誤:", parserError.textContent);
    return;
}

3. 命名空間處理

// 現代瀏覽器帶命名空間查詢
var nsResolver = { prefix: "ns", namespaceURI: "https://example.com/ns" };
var nodes = xmlDom.evaluate("//ns:book", xmlDom, nsResolver, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);

// IE
xmlDom.setProperty("SelectionLanguage", "XPath");
xmlDom.setProperty("SelectionNamespaces", "xmlns:ns='https://example.com/ns'");
var nodes = xmlDom.selectNodes("//ns:book");

現代替代方案

1. DOMParser (標準、異步友好)

const parser = new DOMParser();
const xmlDoc = parser.parseFromString(xmlString, "text/xml");

2. XPath 評估 (標準、強大)

const result = document.evaluate("//book/title", xmlDoc, null, XPathResult.STRING_TYPE, null);
console.log(result.stringValue);

3. 第三方庫(推薦複雜場景)

  • xmldom (Node.js 環境完整 DOM 實現)
  • fast-xml-parser (高性能、流式解析、TypeScript 支持)
  • xml2js (XML ↔ JSON 雙向轉換)

總結

跨瀏覽器 XML 解析的核心在於:統一創建 DOM 文檔入口,分支處理查詢 API 差異。封裝 XMLParser 類隱藏瀏覽器差異,對外提供一致接口。現代項目優先考慮 DOMParser + XPath 或成熟第三方庫,僅在維護 IE 兼容的舊系統中使用 ActiveX 方案。理解兩套 API 的異同,是處理異構數據源的關鍵技能。

copyright © 萬盛學電腦網 all rights reserved