2.0 KiB
XPathEvaluator
The xpath.parse()
method returns an XPathEvaluator
, which contains the following methods.
Each of these methods takes an optional options
object, which can contain any of the following properties:
namespaces
- a namespace resolver. See the documentation page for details.
variables
- a variable resolver. See the documentation page for details.
functions
- a function resolver. See the documentation page for details.
node
- the context node for evaluating the expression
Example usage:
var evaluator = xpath.parse('/characters/character[@greeting = $greeting]');
var character = evaluator.select1({
node: myCharacterDoc,
variables: {
greeting: "Hello, I'm Harry, Harry Potter."
}
});
XPathEvaluator
methods
evaluate([options])
Evaluates the XPath expression and returns the result. The resulting type is determined based on the type of the expression, using the same criteria as xpath.select
.
evaluateNumber([options])
Evaluates the XPath expression and returns the result as a number.
evaluateString([options])
Evaluates the XPath expression and returns the result as a string.
evaluateBoolean([options])
Evaluates the XPath expression and returns the result as a boolean value.
evaluateNodeSet([options])
Evaluates the XPath expression and returns the result as an XNodeSet. See the documentation page for details on this interface.
This is only valid for expressions that evaluate to a node set.
select([options])
Evaluates the XPath expression and returns an array of the resulting nodes, in document order.
This is only valid for expressions that evaluate to a node set.
select1([options])
Evaluates the XPath expression and the first node in the resulting node set, in document order. Returns undefined
This is only valid for expressions that evaluate to a node set.