XPathEvaluator: Methode evaluate()
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.
Die evaluate()
-Methode des XPathEvaluator
-Interfaces
führt einen XPath-Ausdruck auf dem angegebenen Knoten oder Dokument aus und gibt ein
XPathResult
zurück.
Syntax
evaluate(expression, contextNode)
evaluate(expression, contextNode, resolver)
evaluate(expression, contextNode, resolver, type)
evaluate(expression, contextNode, resolver, type, result)
Parameter
expression
-
Ein String, der den zu parsenden und zu evaluierenden XPath-Ausdruck darstellt.
contextNode
-
Ein
Node
, der den Kontext zur Auswertung des Ausdrucks darstellt. resolver
Optional-
Ein
Node
,null
oder jedes Objekt, das die MethodelookupNamespaceURI
implementiert. Erlaubt die Übersetzung aller Präfixe, einschließlich desxml
-Namespace-Präfixes, in geeignete Namespace-URIs innerhalb des XPath-Ausdrucks. type
Optional-
Gibt den Typ des Ergebnisses an, das durch die Evaluierung des Ausdrucks zurückgegeben wird. Dies muss einer der
XPathResult.Constants
sein. result
Optional-
Ermöglicht die Angabe eines Ergebnisobjekts, das möglicherweise von dieser Methode wiederverwendet und zurückgegeben wird. Wenn dies als
null
angegeben ist oder die Implementierung das angegebene Ergebnis nicht wiederverwendet, wird ein neues Ergebnisobjekt zurückgegeben.
Rückgabewert
Ein XPathResult
-Objekt, das das Ergebnis der Evaluierung des XPath-Ausdrucks darstellt.
Ausnahmen
INVALID_EXPRESSION_ERR
Wenn der Ausdruck gemäß den Regeln des XPathEvaluator
nicht legal ist, wird eine DOMException
vom Typ INVALID_EXPRESSION_ERR
ausgelöst.
TYPE_ERR
Falls das Ergebnis nicht in den angegebenen Typ konvertiert werden kann, wird eine DOMException
vom Typ TYPE_ERR
ausgelöst.
NAMESPACE_ERR
Wenn der Ausdruck Namespace-Präfixe enthält, die vom angegebenen XPathNSResolver
nicht aufgelöst werden können, wird eine DOMException
vom Typ NAMESPACE_ERROR
ausgelöst.
WRONG_DOCUMENT_ERR
Wenn der bereitgestellte Kontextknoten aus einem Dokument stammt, das vom XPathEvaluator
nicht unterstützt wird, wird eine DOMException
vom Typ WRONG_DOCUMENT_ERR
ausgelöst.
NOT_SUPPORTED_ERR
Wenn der bereitgestellte Kontextknoten ein nicht als XPath-Kontextknoten erlaubter Typ ist oder der Anforderungstyp vom XPathEvaluator
nicht erlaubt ist, wird eine DOMException
vom Typ NOT_SUPPORTED_ERR
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 evaluator = new XPathEvaluator();
const result = evaluator.evaluate(
"//div",
document,
null,
XPathResult.ORDERED_NODE_SNAPSHOT_TYPE,
);
document.querySelector("output").textContent = result.snapshotLength;
Ergebnis
Spezifikationen
Specification |
---|
DOM> # dom-xpathevaluatorbase-evaluate> |
Browser-Kompatibilität
Loading…