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 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

This feature is defined in the following specifications:

Browser compatibility

See also