Document: createNodeIterator() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

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

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

返値

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

例

js
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() メソッドを持つオブジェクトを使用しています。

js
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);
}

仕様書

Specification

DOM
# dom-document-createnodeiterator

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年6月24日 by MDN contributors.

View this page on GitHub • Report a problem with this content

ドキュメントオブジェクトモデル (DOM)
Document
コンストラクター
1. Document()
インスタンスプロパティ
静的メソッド
1. parseHTML()
2. parseHTMLUnsafe()
インスタンスメソッド
イベント
継承
1. Node
2. EventTarget
DOM に関連するページ
ガイド
1. DOM の構造
2. 属性の反映
3. DOM ツリー上の選択と走査
4. DOM ツリーの構築と更新
5. イベントの扱い

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	Shows ProcessingInstruction nodes.
NodeFilter.SHOW_TEXT	4	Text ノードを表します。

Document: createNodeIterator() メソッド

In this article

構文

引数

返値

例

仕様書

ブラウザーの互換性

Help improve MDN