XPathEvaluator
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The XPathEvaluator interface allows to compile and evaluate XPath expressions.
Constructor
XPathEvaluator()-
Creates a new
XPathEvaluatorobject.
Instance methods
XPathEvaluator.createExpression()-
Creates a parsed XPath expression with resolved namespaces.
XPathEvaluator.createNSResolver()-
Returns the input as-is.
XPathEvaluator.evaluate()-
Evaluates an XPath expression string and returns a result of the specified type if possible.
Example
Count the number of <div> elements
The following example shows the use of the XPathEvaluator interface.
HTML
html
<div>XPath example</div>
<div>Number of <div> elements: <output></output></div>
JavaScript
js
const xpath = "//div";
const evaluator = new XPathEvaluator();
const expression = evaluator.createExpression(xpath);
const result = expression.evaluate(
document,
XPathResult.ORDERED_NODE_SNAPSHOT_TYPE,
);
document.querySelector("output").textContent = result.snapshotLength;
Result
Specifications
| Specification |
|---|
| DOM # interface-xpathevaluator |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
XPathEvaluator
|
|
|
|
|
|
|
|
|
|
|
|
|
XPathEvaluator() constructor
|
|
|
|
|
|
|
|
|
|
|
|
|
createExpression
|
|
|
|
|
|
|
|
|
|
|
|
|
createNSResolver
|
|
|
|
|
|
|
|
|
|
|
|
|
evaluate
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Deprecated. Not for use in new websites.