XPathEvaluator: createExpression()-Methode

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.

Diese Methode kompiliert ein XPathExpression, das dann für (wiederholte) Auswertungen des XPath-Ausdrucks verwendet werden kann.

Syntax

js
createExpression(expression)
createExpression(expression, resolver)

Parameter

expression

Ein String, der den zu erstellenden XPath-Ausdruck darstellt.

resolver Optional

Ein Node, null oder ein Objekt, das die Methode lookupNamespaceURI implementiert. Erlaubt die Übersetzung aller Präfixe, einschließlich des xml-Namensraum-Präfixes, innerhalb des XPath-Ausdrucks in geeignete Namensraum-URIs.

Rückgabewert

Ein XPathExpression, das die kompilierte Form des XPath-Ausdrucks darstellt.

Ausnahmen

INVALID_EXPRESSION_ERR

Wenn der Ausdruck gemäß den Regeln des XPathEvaluator nicht zulässig ist, wird eine XPathException vom Typ INVALID_EXPRESSION_ERR ausgelöst.

NAMESPACE_ERR

Wenn der Ausdruck Namensraum-Präfixe enthält, die vom angegebenen XPathNSResolver nicht aufgelöst werden können, wird eine DOMException vom Typ NAMESPACE_ERROR ausgelöst.

Beispiele

Das folgende Beispiel zeigt die Verwendung der evaluate()-Methode.

HTML

html
<div>XPath example</div>
<div>Number of &lt;div&gt;s: <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;

Ergebnis

Spezifikationen

Specification
DOM Standard
# dom-xpathevaluatorbase-createexpression

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch