XPathEvaluator.createExpression()

您正在阅读此内容的英文版本,因为该语系尚未翻译。 帮助我们翻译此文章吧!

This method compiles an XPathExpression which can then be used for (repeated) evaluations of the XPath expression.

Syntax

XPathExpression XPathEvaluator.createExpression(expression, resolver);

Parameters

expression
A DOMString representing representing the XPath expression to be created.
resolver 可选
Permits translation of all prefixes, including the xml namespace prefix, within the XPath expression into appropriate namespace URIs.

返回值

A XPathExpression representing the compiled form of the XPath expression.

特殊情况

INVALID_EXPRESSION_ERR

If the expression is not legal according to the rules of the XPathEvaluator, an XPathException of type INVALID_EXPRESSION_ERR is raised.

NAMESPACE_ERR

If the expression contains namespace prefixes which cannot be resolved by the specified XPathNSResolver, a DOMException of type NAMESPACE_ERROR is raised.

Example

The following example shows the use of the evaluate() method.

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
XPathEvaluator.createExpression()
Recommendation Initial definition

Browser compatibility

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

See also