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 Juli 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.
resolverOptional-
Ein
Node,nulloder ein beliebiges Objekt, das die MethodelookupNamespaceURIimplementiert. Erlaubt die Übersetzung aller Präfixe, einschließlich des Präfixes für denxml-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
<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 # dom-xpathevaluatorbase-createexpression |
Browser-Kompatibilität
Loading…