大网数据广告活动
Web 标准与前端开发

XPathEvaluator: evaluate() method

· 52CE 我爱测

The `evaluate()` method of the XPathEvaluator interface executes an XPath expression on the given node or document and returns an XPathResult.

DOM

The evaluate() method of the XPathEvaluator interface executes an XPath expression on the given node or document and returns an XPathResult.

Syntax

evaluate(expression, contextNode)
evaluate(expression, contextNode, resolver)
evaluate(expression, contextNode, resolver, type)
evaluate(expression, contextNode, resolver, type, result)

Parameters

  • expression
    • : A string representing the XPath expression to be parsed and evaluated.
  • contextNode
    • : A Node representing the context to use for evaluating the expression.
  • resolver
    • : A Node, null, or any object implementing the Node/lookupNamespaceURI method. Permits translation of all prefixes, including the xml namespace prefix, within the XPath expression into appropriate namespace URIs.
  • type
    • : Specifies the type of result to be returned by evaluating the expression. This must be one of the XPathResult.
  • result
    • : Allows you to specify a result object which may be reused and returned by this method. If this is specified as null or the implementation does not reuse the specified result, a new result object will be returned.

Return value

An XPathResult object representing the result of evaluating the XPath expression.

Exceptions

INVALID_EXPRESSION_ERR

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

TYPE_ERR

In case result cannot be converted to the specified type, a DOMException of type TYPE_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.

WRONG_DOCUMENT_ERR

If the provided context node is from a document that is not supported by the XPathEvaluator, a DOMException of type WRONG_DOCUMENT_ERR is raised.

NOT_SUPPORTED_ERR

If the provided context node is not a type permitted as an XPath context node or the request type is not permitted by the XPathEvaluator, a DOMException of type NOT_SUPPORTED_ERR is raised.

Examples

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

const evaluator = new XPathEvaluator();
const result = evaluator.evaluate(
  "//div",
  document,
  null,
  XPathResult.ORDERED_NODE_SNAPSHOT_TYPE,
);
document.querySelector("output").textContent = result.snapshotLength;

Result

Examples

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。