Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

XPathResult: iterateNext()-Methode

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 iterateNext()-Methode des XPathResult-Interfaces iteriert über ein Knotensatz-Ergebnis und gibt den nächsten Knoten daraus zurück oder null, wenn keine weiteren Knoten vorhanden sind.

Syntax

js
iterateNext()

Parameter

Keine.

Rückgabewert

Der nächste Node innerhalb des Knotensatzes des XPathResult.

Ausnahmen

TYPE_ERR

Wenn XPathResult.resultType nicht UNORDERED_NODE_ITERATOR_TYPE oder ORDERED_NODE_ITERATOR_TYPE ist, wird ein DOMException vom Typ TYPE_ERR ausgelöst.

INVALID_STATE_ERR

Wenn das Dokument seit der Rückgabe des Ergebnisses verändert wurde, wird ein DOMException vom Typ INVALID_STATE_ERR ausgelöst.

Beispiele

Das folgende Beispiel zeigt die Verwendung der iterateNext()-Methode.

HTML

html
<div>XPath example</div>
<div>Tag names of the matched nodes: <output></output></div>

JavaScript

js
const xpath = "//div";
const result = document.evaluate(
  xpath,
  document,
  null,
  XPathResult.ANY_TYPE,
  null,
);
let node = null;
const tagNames = [];
while ((node = result.iterateNext())) {
  tagNames.push(node.localName);
}
document.querySelector("output").textContent = tagNames.join(", ");

Ergebnis

Spezifikationen

Specification
DOM
# dom-xpathresult-iteratenext

Browser-Kompatibilität