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.

Das XPathResult-Interface 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 dieses Interface 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: Bezeichnet, 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 repräsentiert, wie er durch die Typenkonstanten definiert ist.
XPathResult.singleNodeValue Schreibgeschützt: Ein Node, der den Wert des Einzelknotenergebnisses darstellt, welches 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 ein Knotensatz 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 der Reichweite der Knoten liegt. Im Gegensatz zum Iterator-Ergebnis wird der Snapshot nicht ungültig, entspricht jedoch möglicherweise nicht dem aktuellen Dokument, wenn dieses verändert wird.

Konstanten

Ergebnistypdefinierte Konstante	Wert	Beschreibung
`ANY_TYPE`	`0`	Ein Ergebnisdatensatz, der den Typ enthält, der sich natürlich aus der Auswertung des Ausdrucks ergibt. Beachten Sie, dass, wenn das Ergebnis ein Knotensatz ist, `UNORDERED_NODE_ITERATOR_TYPE` immer der resultierende Typ ist.
`NUMBER_TYPE`	`1`	Ein Ergebnis, das eine einzelne Zahl enthält. Dies ist zum Beispiel nützlich 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 zum Beispiel nützlich in einem XPath-Ausdruck, der die `not()`-Funktion verwendet.
`UNORDERED_NODE_ITERATOR_TYPE`	`4`	Ein Ergebnis-Knotensatz, der alle Knoten enthält, die dem Ausdruck entsprechen. Die Knoten müssen nicht unbedingt in der gleichen Reihenfolge erscheinen, in der sie im Dokument vorkommen.
`ORDERED_NODE_ITERATOR_TYPE`	`5`	Ein Ergebnis-Knotensatz, der 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 Ergebnis-Knotensatz, der Schnappschüsse aller Knoten enthält, die dem Ausdruck entsprechen. Die Knoten müssen nicht unbedingt in der gleichen Reihenfolge erscheinen, in der sie im Dokument vorkommen.
`ORDERED_NODE_SNAPSHOT_TYPE`	`7`	Ein Ergebnis-Knotensatz, der 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 Ergebnis-Knotensatz, der 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 Ergebnis-Knotensatz, der den ersten Knoten im Dokument enthält, der dem Ausdruck entspricht.

Spezifikationen

Specification
DOM # interface-xpathresult