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