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 Knoten eines DOM-Teilbaums in Dokumentenreihenfolge zu durchlaufen.

Syntax

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

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

Instanz-Eigenschaften

Diese Schnittstelle erbt keine Eigenschaften.

NodeIterator.root Nur lesbar

Gibt ein Node zurück, das den Wurzelknoten darstellt, wie beim Erstellen des NodeIterator festgelegt wurde.

NodeIterator.whatToShow Nur lesbar

Gibt ein unsigned long Bitmaske zurück, die die Typen von Node beschreibt, die übereinstimmen sollen. Nicht übereinstimmende Knoten werden übersprungen, aber relevante Kindknoten können enthalten sein.

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

Konstante Zahlenwert Beschreibung
NodeFilter.SHOW_ALL 4294967295 (das ist der Maximalwert von unsigned long) Zeigt alle Knoten.
NodeFilter.SHOW_ATTRIBUTE Veraltet 2 Zeigt Attribut-Attr-Knoten. Dies ist nur sinnvoll, wenn ein NodeIterator mit einem Attr-Knoten als seine Wurzel erstellt wird; in diesem Fall bedeutet es, dass der Attributknoten in der ersten Position der Iteration oder des Durchlaufs erscheint. Da Attribute niemals Kinder anderer Knoten sind, erscheinen sie nicht beim Durchlaufen des Dokumentbaums.
NodeFilter.SHOW_CDATA_SECTION Veraltet 8 Zeigt CDATASection-Knoten.
NodeFilter.SHOW_COMMENT 128 Zeigt Comment-Knoten.
NodeFilter.SHOW_DOCUMENT 256 Zeigt Document-Knoten.
NodeFilter.SHOW_DOCUMENT_FRAGMENT 1024 Zeigt DocumentFragment-Knoten.
NodeFilter.SHOW_DOCUMENT_TYPE 512 Zeigt DocumentType-Knoten.
NodeFilter.SHOW_ELEMENT 1 Zeigt Element-Knoten.
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.
NodeFilter.SHOW_TEXT 4 Zeigt Text-Knoten.
NodeIterator.filter Nur lesbar

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

NodeIterator.referenceNode Nur lesbar Experimentell

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

NodeIterator.pointerBeforeReferenceNode Nur lesbar

Gibt ein Boolean zurück, das angibt, ob der NodeIterator vor dem NodeIterator.referenceNode verankert ist. Wenn false, bedeutet das, dass der Iterator nach dem Referenzknoten verankert ist.

Instanz-Methoden

Diese Schnittstelle erbt keine Methoden.

NodeIterator.detach() Veraltet

Dies ist eine veraltete Methode und hat keine Wirkung mehr. Früher diente sie dazu, einen NodeIterator als entsorgt zu markieren, sodass er durch die Speicherbereinigung wieder freigegeben 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 Standard
# interface-nodeiterator

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch