MDN self-hosted library · e01.org

XPathEvaluator

DOM

DOM

The XPathEvaluator interface allows you 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()
  • : 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

<div>XPath example</div>
<div>Number of &lt;div&gt; elements: <output></output></div>

JavaScript

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

100%

Specifications

Browser compatibility

See also

  • document.createExpression()
  • XPathExpression