XPathResult

Baseline

Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Die Schnittstelle XPathResult repräsentiert die Ergebnisse, die bei der Auswertung eines XPath-Ausdrucks im Kontext eines bestimmten Knotens entstehen.

Da XPath-Ausdrücke unterschiedliche Ergebnistypen liefern können, ermöglicht diese Schnittstelle, den Typ und den Wert des Ergebnisses zu bestimmen und zu verarbeiten.

Konstanten

Konstante für den Ergebnistyp	Wert	Beschreibung
`ANY_TYPE`	`0`	Ein Ergebnis des Typs, der sich bei der Auswertung des Ausdrucks ergibt. Beachten Sie, dass bei einer Knotenmenge immer `UNORDERED_NODE_ITERATOR_TYPE` der resultierende Typ ist.
`NUMBER_TYPE`	`1`	Ein Ergebnis, das eine einzelne Zahl enthält. Dies ist beispielsweise bei einem XPath-Ausdruck mit der Funktion `count()` nützlich.
`STRING_TYPE`	`2`	Ein Ergebnis, das eine einzelne Zeichenfolge enthält.
`BOOLEAN_TYPE`	`3`	Ein Ergebnis, das einen einzelnen booleschen Wert enthält. Dies ist beispielsweise bei einem XPath-Ausdruck mit der Funktion `not()` nützlich.
`UNORDERED_NODE_ITERATOR_TYPE`	`4`	Eine Ergebnisknotenmenge, die alle Knoten enthält, die dem Ausdruck entsprechen. Die Knoten sind nicht unbedingt in derselben Reihenfolge angeordnet wie im Dokument.
`ORDERED_NODE_ITERATOR_TYPE`	`5`	Eine Ergebnisknotenmenge, die alle Knoten enthält, die dem Ausdruck entsprechen. Die Knoten in der Ergebnismenge sind in derselben Reihenfolge angeordnet wie im Dokument.
`UNORDERED_NODE_SNAPSHOT_TYPE`	`6`	Eine Ergebnisknotenmenge, die Momentaufnahmen aller Knoten enthält, die dem Ausdruck entsprechen. Die Knoten sind nicht unbedingt in derselben Reihenfolge angeordnet wie im Dokument.
`ORDERED_NODE_SNAPSHOT_TYPE`	`7`	Eine Ergebnisknotenmenge, die Momentaufnahmen aller Knoten enthält, die dem Ausdruck entsprechen. Die Knoten in der Ergebnismenge sind in derselben Reihenfolge angeordnet wie im Dokument.
`ANY_UNORDERED_NODE_TYPE`	`8`	Eine Ergebnisknotenmenge, die einen beliebigen einzelnen Knoten enthält, der dem Ausdruck entspricht. Dieser Knoten ist nicht unbedingt der erste passende Knoten im Dokument.
`FIRST_ORDERED_NODE_TYPE`	`9`	Eine Ergebnisknotenmenge, die den ersten Knoten im Dokument enthält, der dem Ausdruck entspricht.

Instanzeigenschaften

XPathResult.booleanValue Schreibgeschützt: Ein boolean, der den Wert des Ergebnisses angibt, wenn resultType den Wert BOOLEAN_TYPE hat.
XPathResult.invalidIteratorState Schreibgeschützt: Gibt an, ob der Iterator ungültig geworden ist. Der Wert ist true, wenn resultType den Wert UNORDERED_NODE_ITERATOR_TYPE oder ORDERED_NODE_ITERATOR_TYPE hat und das Dokument seit der Rückgabe dieses Ergebnisses geändert wurde.
XPathResult.numberValue Schreibgeschützt: Eine number, die den Wert des Ergebnisses angibt, wenn resultType den Wert NUMBER_TYPE hat.
XPathResult.resultType Schreibgeschützt: Ein numerischer Code (number), der den Typ des Ergebnisses gemäß den Typkonstanten angibt.
XPathResult.singleNodeValue Schreibgeschützt: Ein Node, der den Wert des Ergebnisses mit einem einzelnen Knoten angibt und auch null sein kann.
XPathResult.snapshotLength Schreibgeschützt: Die Anzahl der Knoten in der Ergebnismomentaufnahme.
XPathResult.stringValue Schreibgeschützt: Eine Zeichenfolge, die den Wert des Ergebnisses angibt, wenn resultType den Wert STRING_TYPE hat.

Instanzmethoden

XPathResult.iterateNext(): Wenn das Ergebnis eine Knotenmenge ist, durchläuft diese Methode die Menge und gibt den nächsten Knoten zurück oder null, wenn keine weiteren Knoten vorhanden sind.
XPathResult.snapshotItem(): Gibt ein Element der Momentaufnahmensammlung zurück oder null, wenn der Index außerhalb des Knotenbereichs liegt. Anders als ein Iteratorergebnis wird die Momentaufnahme nicht ungültig. Wurde das Dokument jedoch geändert, entspricht sie ihm möglicherweise nicht mehr.

Spezifikationen

Spezifikation
DOM # interface-xpathresult

Browser-Kompatibilität

Siehe auch

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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