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, wenn resultType BOOLEAN_TYPE ist.

XPathResult.invalidIteratorState Nur lesbar

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 Nur lesbar

Eine number, die den Wert des Ergebnisses darstellt, wenn resultType 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, das null 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

Siehe auch