XPathResult
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.
Die XPathResult
-Schnittstelle repräsentiert die Ergebnisse, die durch die Auswertung eines XPath-Ausdrucks im Kontext eines bestimmten Knotens erzeugt werden.
Da XPath-Ausdrücke zu verschiedenen Ergebnisarten führen können, ermöglicht diese Schnittstelle die Bestimmung und Handhabung des Typs und Werts des Ergebnisses.
Instanzeigenschaften
XPathResult.booleanValue
Nur lesbar-
Ein
boolean
, der den Wert des Ergebnisses darstellt, wennresultType
BOOLEAN_TYPE
ist. XPathResult.invalidIteratorState
Nur lesbar-
Bedeutet, dass der Iterator ungültig geworden ist. Er ist
true
, wennresultType
UNORDERED_NODE_ITERATOR_TYPE
oderORDERED_NODE_ITERATOR_TYPE
ist und das Dokument seit der Rückgabe dieses Ergebnisses geändert wurde. XPathResult.numberValue
Nur lesbar-
Eine
number
, die den Wert des Ergebnisses darstellt, wennresultType
NUMBER_TYPE
ist. XPathResult.resultType
Nur lesbar-
Ein
number
-Code, der den Typ des Ergebnisses darstellt, wie durch die Typkonstanten definiert. XPathResult.singleNodeValue
Nur lesbar-
Ein
Node
, der den Wert des einzelnen Knotenergebnisses darstellt, dasnull
sein kann. XPathResult.snapshotLength
Nur lesbar-
Die Anzahl der Knoten im Ergebnissnapshot.
XPathResult.stringValue
Nur lesbar-
Ein String, der den Wert des Ergebnisses darstellt, wenn
resultType
STRING_TYPE
ist.
Instanzmethoden
XPathResult.iterateNext()
-
Wenn das Ergebnis eine Menge von Knoten ist, iteriert diese Methode darüber und gibt den nächsten Knoten daraus zurück oder
null
, wenn keine weiteren Knoten vorhanden sind. XPathResult.snapshotItem()
-
Gibt ein Element der Snapshot-Sammlung zurück oder
null
, wenn der Index nicht innerhalb des Bereichs der Knoten liegt. Im Gegensatz zu dem Iterator-Ergebnis wird der Snapshot nicht ungültig, kann jedoch nicht dem aktuellen Dokument entsprechen, wenn dieses verändert wird.
Konstanten
Ergebnistyp Definierte Konstante | Wert | Beschreibung |
---|---|---|
ANY_TYPE |
0 |
Ein Ergebnissatz, der den natürlichen Typ des Ergebnisses der Auswertung des Ausdrucks enthält. Beachten Sie, dass, wenn das Ergebnis ein Knoten-Set ist, immer UNORDERED_NODE_ITERATOR_TYPE der resultierende Typ ist. |
NUMBER_TYPE |
1 |
Ein Ergebnis, das eine einzelne Zahl enthält. Dies ist nützlich, zum Beispiel in einem XPath-Ausdruck, der die count() -Funktion verwendet. |
STRING_TYPE |
2 |
Ein Ergebnis, das einen einzelnen String enthält. |
BOOLEAN_TYPE |
3 |
Ein Ergebnis, das einen einzelnen booleschen Wert enthält. Dies ist nützlich, zum Beispiel in einem XPath-Ausdruck, der die not() -Funktion verwendet. |
UNORDERED_NODE_ITERATOR_TYPE |
4 |
Ein Ergebnisknoten-Set, das alle Knoten enthält, die dem Ausdruck entsprechen. Die Knoten sind möglicherweise nicht in der gleichen Reihenfolge wie sie im Dokument erscheinen. |
ORDERED_NODE_ITERATOR_TYPE |
5 |
Ein Ergebnisknoten-Set, das alle Knoten enthält, die dem Ausdruck entsprechen. Die Knoten sind in der Reihenfolge, in der sie im Dokument erscheinen. |
UNORDERED_NODE_SNAPSHOT_TYPE |
6 |
Ein Ergebnisknoten-Set, das Snapshots aller Knoten enthält, die dem Ausdruck entsprechen. Die Knoten sind möglicherweise nicht in der gleichen Reihenfolge wie sie im Dokument erscheinen. |
ORDERED_NODE_SNAPSHOT_TYPE |
7 |
Ein Ergebnisknoten-Set, das Snapshots aller Knoten enthält, die dem Ausdruck entsprechen. Die Knoten sind in der Reihenfolge, in der sie im Dokument erscheinen. |
ANY_UNORDERED_NODE_TYPE |
8 |
Ein Ergebnisknoten-Set, das einen beliebigen einzelnen Knoten enthält, der dem Ausdruck entspricht. Der Knoten ist nicht unbedingt der erste Knoten im Dokument, der dem Ausdruck entspricht. |
FIRST_ORDERED_NODE_TYPE |
9 |
Ein Ergebnisknoten-Set, das den ersten Knoten im Dokument enthält, der dem Ausdruck entspricht. |
Spezifikationen
Specification |
---|
DOM Standard # interface-xpathresult |
Browser-Kompatibilität
BCD tables only load in the browser