XPathEvaluator

The XPathEvaluator interface allows to compile and evaluate XPath expressions.

Constructor

XPathEvaluator()

Creates a new XPathEvaluator object.

Instance methods

XPathEvaluator.createExpression()

Creates a parsed XPath expression with resolved namespaces.

XPathEvaluator.createNSResolver() Deprecated

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 &lt;div&gt; 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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
XPathEvaluator 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4
XPathEvaluator 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4
createExpression 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4
createNSResolver 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4
evaluate 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4

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