Document.createNodeIterator() メソッドは、新しいNodeIterator オブジェクトを返します。

構文

createNodeIterator(root)createNodeIterator(root, whatToShow)createNodeIterator(root, whatToShow, filter)

引数

root

NodeIterator の探索の開始地点になるルートノードです。

whatToShow省略可

オプションのunsigned long 値で、NodeFilter の定数プロパティを組み合わせて作られたビットマスクを表します。これは特定の種類のノードを絞り込みするのに便利な方法です。既定値は0xFFFFFFFF で、SHOW_ALL 定数を表します。

定数	数値	説明
NodeFilter.SHOW_ALL	4294967295 (すなわちunsigned long の最大値)	すべてのノードを表します。
NodeFilter.SHOW_ATTRIBUTE非推奨;	2	属性Attr ノードを表します。これは、Attr ノードをルートとしてNodeIterator を作成した場合にのみ意味を持ちます。この場合、その属性ノードが反復や探索の最初の位置に現れることを意味します。属性は他のノードの子ではないので、文書ツリーを探索しても現れません。
NodeFilter.SHOW_CDATA_SECTION非推奨;	8	CDATASection ノードを表します。
NodeFilter.SHOW_COMMENT	128	Comment ノードを表します。
NodeFilter.SHOW_DOCUMENT	256	Document ノードを表します。
NodeFilter.SHOW_DOCUMENT_FRAGMENT	1024	DocumentFragment ノードを表します。
NodeFilter.SHOW_DOCUMENT_TYPE	512	DocumentType ノードを表します。
NodeFilter.SHOW_ELEMENT	1	Element ノードを表します。
NodeFilter.SHOW_ENTITY非推奨;	32	古い値で、もう使用できません。
NodeFilter.SHOW_ENTITY_REFERENCE非推奨;	16	古い値で、もう使用できません。
NodeFilter.SHOW_NOTATION非推奨;	2048	古い値で、もう使用できません。
NodeFilter.SHOW_PROCESSING_INSTRUCTION	64	ShowsProcessingInstruction nodes.
NodeFilter.SHOW_TEXT	4	Text ノードを表します。

filter省略可

コールバック関数またはacceptNode() メソッドを持つオブジェクトです。この関数またはメソッドは、この関数またはメソッドは、サブツリー内の各ノードのうち whatToShow フラグで含まれると受け入れられたノードに対して呼び出され、反復可能オブジェクトのリストに記載するかどうかを決定します。このメソッドはNodeFilter.FILTER_ACCEPT、NodeFilter.FILTER_REJECT、NodeFilter.FILTER_SKIP のいずれかを返す必要があります。例を参照してください。

返値

新しいNodeIterator オブジェクトです。

例

const nodeIterator = document.createNodeIterator(  document.body,  NodeFilter.SHOW_ELEMENT,  (node) =>    node.nodeName.toLowerCase() === "p"      ? NodeFilter.FILTER_ACCEPT      : NodeFilter.FILTER_REJECT,);const pars = [];let currentNode;while ((currentNode = nodeIterator.nextNode())) {  pars.push(currentNode);}

同じ動作ですが、acceptNode() メソッドを持つオブジェクトを使用しています。

const nodeIterator = document.createNodeIterator(  document.body,  NodeFilter.SHOW_ELEMENT,  {    acceptNode(node) {      return node.nodeName.toLowerCase() === "p"        ? NodeFilter.FILTER_ACCEPT        : NodeFilter.FILTER_REJECT;    },  },);const pars = [];let currentNode;while ((currentNode = nodeIterator.nextNode())) {  pars.push(currentNode);}

仕様書

ブラウザーの互換性