XPathEvaluator: createExpression() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
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.
resolverOptional-
Ein
Node,nulloder jedes Objekt, das dielookupNamespaceURI-Methode implementiert. Erlaubt die Übersetzung aller Präfixe, einschließlich desxml-Namensraumpräfixes, innerhalb des XPath-Ausdrucks in entsprechende Namensraum-URIs.
Rückgabewert
Ein XPathExpression, das die kompilierte Form des XPath-Ausdrucks darstellt.
Ausnahmen
INVALID_EXPRESSION_ERR
Wenn der Ausdruck nicht den Regeln des XPathEvaluator entspricht, wird eine DOMException des Typs
INVALID_EXPRESSION_ERR ausgelöst.
NAMESPACE_ERR
Wenn der Ausdruck Namensraumpräfixe enthält, die durch den spezifizierten
XPathNSResolver nicht aufgelöst werden können, wird eine DOMException des Typs
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
| Spezifikation |
|---|
| DOM # dom-xpathevaluatorbase-createexpression |