XPathResult
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 XPathResult Schnittstelle repräsentiert die Ergebnisse, die durch die Auswertung eines XPath-Ausdrucks im Kontext eines gegebenen Knotens erzeugt werden.
Da XPath-Ausdrücke zu verschiedenen Ergebnisarten führen können, ermöglicht diese Schnittstelle die Bestimmung und Behandlung des Typs und Wertes des Ergebnisses.
Instanzeigenschaften
XPathResult.booleanValueSchreibgeschützt-
Ein
boolean, der den Wert des Ergebnisses darstellt, wennresultTypeBOOLEAN_TYPEist. XPathResult.invalidIteratorStateSchreibgeschützt-
Signifiziert, dass der Iterator ungültig geworden ist. Er ist
true, wennresultTypeUNORDERED_NODE_ITERATOR_TYPEoderORDERED_NODE_ITERATOR_TYPEist und das Dokument seit der Rückgabe dieses Ergebnisses geändert wurde. XPathResult.numberValueSchreibgeschützt-
Eine
number, die den Wert des Ergebnisses darstellt, wennresultTypeNUMBER_TYPEist. XPathResult.resultTypeSchreibgeschützt-
Ein
number-Code, der den Typ des Ergebnisses darstellt, wie durch die Typkonstanten definiert. XPathResult.singleNodeValueSchreibgeschützt-
Ein
Node, der den Wert des einzelnen Knoten-Ergebnisses darstellt, das möglicherweisenullist. XPathResult.snapshotLengthSchreibgeschützt-
Die Anzahl der Knoten im Ergebnis-Snapshot.
XPathResult.stringValueSchreibgeschützt-
Ein String, der den Wert des Ergebnisses darstellt, wenn
resultTypeSTRING_TYPEist.
Instanzmethoden
XPathResult.iterateNext()-
Wenn das Ergebnis ein Knoten-Set ist, durchläuft diese Methode es und gibt den nächsten Knoten zurück oder
null, wenn keine weiteren Knoten vorhanden sind. XPathResult.snapshotItem()-
Gibt ein Element der Snapshot-Sammlung zurück oder
null, falls der Index nicht innerhalb des Bereichs der Knoten liegt. Im Gegensatz zu den Iterator-Ergebnissen wird der Snapshot nicht ungültig, kann aber nicht mehr dem aktuellen Dokument entsprechen, wenn dieses verändert wird.
Konstanten
| Definierte Konstante des Ergebnistyps | Wert | Beschreibung |
|---|---|---|
ANY_TYPE |
0 |
Ein Ergebnisset, das den Typ enthält, der sich natürlich aus der
Auswertung des Ausdrucks ergibt. Beachten Sie, dass wenn das Ergebnis ein
Knoten-Set ist, dann UNORDERED_NODE_ITERATOR_TYPE immer 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 boolean-Wert enthält. Dies ist
nützlich, zum Beispiel in einem XPath-Ausdruck, der die
not()-Funktion verwendet.
|
UNORDERED_NODE_ITERATOR_TYPE |
4 |
Ein Knoten-Set-Ergebnis, das alle Knoten enthält, die dem Ausdruck entsprechen. Die Knoten sind möglicherweise nicht in der Reihenfolge, in der sie im Dokument erscheinen. |
ORDERED_NODE_ITERATOR_TYPE |
5 |
Ein Knoten-Set-Ergebnis, das alle Knoten enthält, die dem Ausdruck entsprechen. Die Knoten im Ergebnisset sind in der gleichen Reihenfolge, in der sie im Dokument erscheinen. |
UNORDERED_NODE_SNAPSHOT_TYPE |
6 |
Ein Knoten-Set-Ergebnis, das Schnappschüsse aller Knoten enthält, die dem Ausdruck entsprechen. Die Knoten sind möglicherweise nicht in der Reihenfolge, in der sie im Dokument erscheinen. |
ORDERED_NODE_SNAPSHOT_TYPE |
7 |
Ein Knoten-Set-Ergebnis, das Schnappschüsse aller Knoten enthält, die dem Ausdruck entsprechen. Die Knoten im Ergebnisset sind in der gleichen Reihenfolge, in der sie im Dokument erscheinen. |
ANY_UNORDERED_NODE_TYPE |
8 |
Ein Knoten-Set-Ergebnis, das einen beliebigen einzelnen Knoten enthält, der dem Ausdruck entspricht. Der Knoten ist nicht notwendigerweise der erste Knoten im Dokument, der dem Ausdruck entspricht. |
FIRST_ORDERED_NODE_TYPE |
9 |
Ein Knoten-Set-Ergebnis, das den ersten Knoten im Dokument enthält, der dem Ausdruck entspricht. |
Spezifikationen
| Specification |
|---|
| DOM # interface-xpathresult |