Our volunteers haven't translated this article into עברית yet. Join us and help get the job done!
You can also read the article in English (US).

The XPathEvaluator interface allows to compile and evaluate XPath expressions.

It is implemented by the Document interface.

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

The following example shows the use of the XPathEvaluator interface.

HTML

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

JavaScript

var xpath = "//div";
var evaluator = new XPathEvaluator();
var expression = evaluator.createExpression("//div");
var result = expression.evaluate(document, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE);
document.querySelector("output").textContent = result.snapshotLength;

Result

Specifications

Specification Status Comment
Document Object Model (DOM) Level 3 XPath Specification
The definition of 'XPathEvaluator' in that specification.
Recommendation Initial definition

Browser compatibility

No compatibility data found. Please contribute data for "api.XPathEvaluator" (depth: 1) to the MDN compatibility data repository.

See also

Document Tags and Contributors

Contributors to this page: mdnwebdocs-bot, Sebastianz
Last updated by: mdnwebdocs-bot,