The XPathEvaluator interface allows to compile and evaluate XPath expressions.
On this page
XPathEvaluator
Constructor
-
XPathEvaluator() -
Creates a new
XPathEvaluatorobject.
Instance methods
-
XPathEvaluator.createExpression() -
Creates a parsed XPath expression with resolved namespaces.
-
XPathEvaluator.createNSResolver() -
Adapts any DOM node to resolve namespaces allowing the XPath expression to be evaluated relative to the context of the node where it appeared within the document.
-
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 Standard # interface-xpathevaluator |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
XPathEvaluator |
1 | 12 | 1 | No | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
XPathEvaluator |
1 | 12 | 1 | No | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
createExpression |
1 | 12 | 1 | No | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
createNSResolver |
1 | 12 | 1 | No | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
evaluate |
1 | 12 | 1 | No | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XPathEvaluator