XML DOM evaluate() 方法
XML DOM evaluate() 方法
定义和用法
evaluate() 方法计算一个 XPath 表达式。
语法:
evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
参数 | 描述 |
---|---|
xpathText | 表示要计算的 XPath 表达式的字符串。 |
contextNode | 文档中,对应要计算的表达式的节点。 |
namespaceURLMapper |
把一个命名空间前缀映射为一个全称命名空间 URL 的函数。 如果不需要这样的映射,就为 null。 |
resultType |
指定了期待作为结果的对象的类型,使用 XPath 转换来强制结果类型。 类型的可能的值是 XPathResult 对象所定义的常量。 |
result |
一个复用的 XPathResult 对象; 如果你要创建一个新的 XPathResult 对象,则为 null。 |
返回值
表示根据给定的 Context 节点计算的表达式的一个 XPathResult 对象。
抛出
如果 xpathText 包含语法错误,或者如果表达式的结果无法转换为想要的 resultType,或者如果表达式包含了 namespaceURLMapper 无法解析的命名空间,或者如果 contextNode 具有错误的类型或它和这个文档不相关,该方法都会抛出一个异常。
描述
该方法根据给定的 Context 节点来计算指定的 XPath 表达式,并且返回一个 XPathResult 对象,该对象是 type 来确定结果类型应该是什么。如果你想多次计算一个表达式,使用 Document.createExpression() 来把表达式编译成一个 XPathExpression 对象,然后使用 XPathExpression 的 evaluate() 方法。
IE 不支持这个 API。参阅 Node.selectNodes() 和 Node.selectSingleNode() 来了解一个特定于 IE 的替代方法。