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
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 MethodelookupNamespaceURI
implementiert. Erlaubt die Übersetzung aller Präfixe, einschließlich desxml
-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
<div>XPath example</div>
<div>Number of <div>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 Standard # dom-xpathevaluatorbase-createexpression |
Browser-Kompatibilität
BCD tables only load in the browser