Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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.
DieXPathResult 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ütztEin
boolean, der den Wert des Ergebnisses darstellt, wennresultTypeBOOLEAN_TYPEist.XPathResult.invalidIteratorStateSchreibgeschütztSignifiziert, 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ütztEine
number, die den Wert des Ergebnisses darstellt, wennresultTypeNUMBER_TYPEist.XPathResult.resultTypeSchreibgeschütztEin
number-Code, der den Typ des Ergebnisses darstellt, wie durch die Typkonstanten definiert.XPathResult.singleNodeValueSchreibgeschütztEin
Node, der den Wert des einzelnen Knoten-Ergebnisses darstellt, das möglicherweisenullist.XPathResult.snapshotLengthSchreibgeschütztDie Anzahl der Knoten im Ergebnis-Snapshot.
XPathResult.stringValueSchreibgeschütztEin 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, dannUNORDERED_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 diecount()-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 dienot()-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 |