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.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.

Please take two minutes to fill out our short survey.

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:

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` Veraltet	`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` 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

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() Veraltet: 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

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