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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
createExpression

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch