NodeIterator

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 NodeIterator-Schnittstelle repräsentiert einen Iterator, um die Knoten eines DOM-Teilbaums in Dokumentenreihenfolge zu traversieren.

Ein NodeIterator kann mit der Methode Document.createNodeIterator() erstellt werden, wie folgt:

const nodeIterator = document.createNodeIterator(root, whatToShow, filter);

Instanz-Eigenschaften

Diese Schnittstelle erbt keine Eigenschaft.

NodeIterator.root Schreibgeschützt

Gibt einen Node zurück, der den Stammknoten darstellt, wie er beim Erstellen des NodeIterator spezifiziert wurde.

NodeIterator.whatToShow Schreibgeschützt

Gibt eine unsigned long-Bitmaske zurück, die die Arten von Node beschreibt, die übereinstimmen sollen. Nicht-übereinstimmende Knoten werden übersprungen, aber relevante Kindknoten können einbezogen werden.

Die möglichen Bitmasken-Werte sind Konstanten aus der NodeFilter-Schnittstelle:

Konstante	Numerischer Wert	Beschreibung
`NodeFilter.SHOW_ALL`	`4294967295` (das ist der Maximalwert von `unsigned long`)	Zeigt alle Knoten an.
`NodeFilter.SHOW_ATTRIBUTE` Veraltet	`2`	Zeigt Attribut-`[`Attr`](/de/docs/Web/API/Attr)`-Knoten an. Dies ist nur sinnvoll, wenn ein `NodeIterator` mit einem `Attr`-Knoten als Wurzel erstellt wird; in diesem Fall bedeutet es, dass der Attributknoten in der ersten Position der Iteration oder Traversierung erscheint. Da Attribute nie Kinder anderer Knoten sind, erscheinen sie nicht, wenn man durch den Dokumentbaum geht.
`NodeFilter.SHOW_CDATA_SECTION` Veraltet	`8`	Zeigt `CDATASection`-Knoten an.
`NodeFilter.SHOW_COMMENT`	`128`	Zeigt `Comment`-Knoten an.
`NodeFilter.SHOW_DOCUMENT`	`256`	Zeigt `Document`-Knoten an.
`NodeFilter.SHOW_DOCUMENT_FRAGMENT`	`1024`	Zeigt `DocumentFragment`-Knoten an.
`NodeFilter.SHOW_DOCUMENT_TYPE`	`512`	Zeigt `DocumentType`-Knoten an.
`NodeFilter.SHOW_ELEMENT`	`1`	Zeigt `Element`-Knoten an.
`NodeFilter.SHOW_ENTITY` Veraltet	`32`	Veraltet, wird nicht mehr verwendet.
`NodeFilter.SHOW_ENTITY_REFERENCE` Veraltet	`16`	Veraltet, wird nicht mehr verwendet.
`NodeFilter.SHOW_NOTATION` Veraltet	`2048`	Veraltet, wird nicht mehr verwendet.
`NodeFilter.SHOW_PROCESSING_INSTRUCTION`	`64`	Zeigt `ProcessingInstruction`-Knoten an.
`NodeFilter.SHOW_TEXT`	`4`	Zeigt `Text`-Knoten an.

NodeIterator.filter Schreibgeschützt

Gibt einen NodeFilter zurück, der verwendet wird, um die relevanten Knoten auszuwählen.

NodeIterator.referenceNode Schreibgeschützt Experimentell

Gibt den Node zurück, an den der Iterator angeheftet ist.

NodeIterator.pointerBeforeReferenceNode Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob der NodeIterator vor dem NodeIterator.referenceNode verankert ist. Wenn false, zeigt es an, dass der Iterator nach dem Referenzknoten verankert ist.

Instanz-Methoden

Diese Schnittstelle erbt keine Methode.

NodeIterator.detach() Veraltet: Dies ist eine veraltete Methode und hat keine Wirkung mehr. Früher diente sie dazu, einen NodeIterator als aufgelöst zu markieren, damit er durch die Speicherbereinigung zurückgefordert werden konnte.
NodeIterator.previousNode(): Gibt den vorherigen Node im Dokument zurück oder null, wenn es keinen gibt.
NodeIterator.nextNode(): Gibt den nächsten Node im Dokument zurück oder null, wenn es keinen gibt.

Spezifikationen

Specification
DOM # interface-nodeiterator

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Die Erstellermethode: Document.createNodeIterator().
Verwandte Schnittstelle: TreeWalker