XML DOM evaluate() 方法
定義和用法
evaluate() 方法計算一個 XPath 表達式。
語法:
evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
參數 | 描述 |
---|---|
xpathText | 表示要計算的 XPath 表達式的字符串。 |
contextNode | 文檔中,對應要計算的表達式的節(jié)點。 |
namespaceURLMapper |
把一個命名空間前綴映射為一個全稱命名空間 URL 的函數。 如果不需要這樣的映射,就為 null。 |
resultType |
指定了期待作為結果的對象的類型,使用 XPath 轉換來強制結果類型。 類型的可能的值是 XPathResult 對象所定義的常量。 |
result |
一個復用的 XPathResult 對象; 如果你要創(chuàng)建一個新的 XPathResult 對象,則為 null。 |
返回值
表示根據給定的 Context 節(jié)點計算的表達式的一個 XPathResult 對象。
拋出
如果 xpathText 包含語法錯誤,或者如果表達式的結果無法轉換為想要的 resultType,或者如果表達式包含了 namespaceURLMapper 無法解析的命名空間,或者如果 contextNode 具有錯誤的類型或它和這個文檔不相關,該方法都會拋出一個異常。
描述
該方法根據給定的 Context 節(jié)點來計算指定的 XPath 表達式,并且返回一個 XPathResult 對象,該對象是 type 來確定結果類型應該是什么。如果你想多次計算一個表達式,使用 Document.createExpression() 來把表達式編譯成一個 XPathExpression 對象,然后使用 XPathExpression 的 evaluate() 方法。
IE 不支持這個 API。參閱 Node.selectNodes() 和 Node.selectSingleNode() 來了解一個特定于 IE 的替代方法。