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 einen XPathExpression, der dann für (wiederholte) Auswertungen des XPath-Ausdrucks verwendet werden kann.

Syntax

createExpression(expression)
createExpression(expression, resolver)

Parameter

expression: Ein String, der den zu erstellenden XPath-Ausdruck darstellt.
resolver Optional: Ein Node, null oder ein beliebiges Objekt, das die Methode lookupNamespaceURI implementiert. Erlaubt die Übersetzung aller Präfixe, einschließlich des Präfixes für den xml-Namensraum, im XPath-Ausdruck in geeignete Namensraum-URIs.

Rückgabewert

Ein XPathExpression, der 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 DOMException vom Typ INVALID_EXPRESSION_ERR ausgelöst.

NAMESPACE_ERR

Wenn der Ausdruck Namensraumprä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

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 # dom-xpathevaluatorbase-createexpression