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 Schreibgeschützt: Ein boolean, der den Wert des Ergebnisses darstellt, wenn resultType BOOLEAN_TYPE ist.
XPathResult.invalidIteratorState Schreibgeschützt: Bedeutet, dass der Iterator ungültig geworden ist. Er ist true, wenn resultType UNORDERED_NODE_ITERATOR_TYPE oder ORDERED_NODE_ITERATOR_TYPE ist und das Dokument seit der Rückgabe dieses Ergebnisses geändert wurde.
XPathResult.numberValue Schreibgeschützt: Eine number, die den Wert des Ergebnisses darstellt, wenn resultType NUMBER_TYPE ist.
XPathResult.resultType Schreibgeschützt: Ein number-Code, der den Typ des Ergebnisses darstellt, wie durch die Typkonstanten definiert.
XPathResult.singleNodeValue Schreibgeschützt: Ein Node, der den Wert des einzelnen Knotenergebnisses darstellt, das null sein kann.
XPathResult.snapshotLength Schreibgeschützt: Die Anzahl der Knoten im Ergebnissnapshot.
XPathResult.stringValue Schreibgeschützt: 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