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.booleanValue Schreibgeschützt: Ein boolean, der den Wert des Ergebnisses darstellt, wenn resultType BOOLEAN_TYPE ist.
XPathResult.invalidIteratorState Schreibgeschützt: Signifiziert, 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 Knoten-Ergebnisses darstellt, das möglicherweise null ist.
XPathResult.snapshotLength Schreibgeschützt: Die Anzahl der Knoten im Ergebnis-Snapshot.
XPathResult.stringValue Schreibgeschützt: Ein String, der den Wert des Ergebnisses darstellt, wenn resultType STRING_TYPE ist.

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

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden