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 Dokumentreihenfolge zu durchlaufen.

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

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

Instanzeigenschaften

Diese Schnittstelle erbt keine Eigenschaft.

NodeIterator.root Schreibgeschützt

Gibt einen Node zurück, der den Wurzelknoten darstellt, so wie angegeben, als der NodeIterator erstellt wurde.

NodeIterator.whatToShow Schreibgeschützt

Gibt eine 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 Numerischer Wert Beschreibung
NodeFilter.SHOW_ALL 4294967295 (das ist der Maximalwert von unsigned long) Zeigt alle Knoten an.
NodeFilter.SHOW_ATTRIBUTE 2 Zeigt Attribut-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 an erster Stelle der Iteration oder des Durchlaufs erscheint. Da Attribute niemals Kinder anderer Knoten sind, erscheinen sie nicht beim Durchlaufen des Dokumentbaums.
NodeFilter.SHOW_CDATA_SECTION 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 32 Veraltet, wird nicht mehr verwendet.
NodeFilter.SHOW_ENTITY_REFERENCE 16 Veraltet, wird nicht mehr verwendet.
NodeFilter.SHOW_NOTATION 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

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

NodeIterator.pointerBeforeReferenceNode Schreibgeschützt

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

Instanzmethoden

Diese Schnittstelle erbt keine Methode.

NodeIterator.detach()

Dies ist eine veraltete Methode und hat keine Wirkung mehr. Früher diente sie dazu, einen NodeIterator als entsorgt zu markieren, damit er durch die Speicherbereinigung freigegeben werden konnte.

NodeIterator.previousNode()

Gibt den vorhergehenden Node im Dokument zurück, oder null, wenn keiner vorhanden ist.

NodeIterator.nextNode()

Gibt den nächsten Node im Dokument zurück, oder null, wenn keiner vorhanden ist.

Spezifikationen

Specification
DOM
# interface-nodeiterator

Browser-Kompatibilität

Siehe auch