1.1 概要

1.1では，オプションのDOM水準2 たどり の機能を示す。TreeWalker，NodeIterator及びNodeFilterの各インタフェースは，文書の内容の使い易く，頑健であって，選択的なたどりを提供する。

1.に示されるインタフェースは，必須とはしない。DOMアプリケーションは，このモジュールが実装によってサポートされているかどかを決定するために，パラメタ値"Traversal"及び"2.0"をそれぞれ用いてDOMImplementationインタフェースのhasFeature(feature, version)メソッドを使用してもよい。このモジュールを完全にサポートするためには，実装は，DOM水準2 コア規定[DOM Level 2 Core]で定義されている"コア"機能もサポートしなければならない。DOM水準2 コア規定[DOM Level 2 Core]の適合性に関する追加情報を参照すること。

NodeIteratorsインタフェース及びTreeWalkersインタフェースは，文書部分木のノード及びそれらインタフェースが提示するノード内の位置を表現する異なる二つの方法とする。NodeIteratorは，部分木の平坦化されたビューをノードの順序付けされた列として提示する。この場合，ノードの列は，文書順に提示される。このビューは階層に関係なく提示されるので，繰返し子(iterator)には，前後に移動するメソッドは存在するが，上下に移動するメソッドは存在しない。逆に，TreeWalkerは，部分木の階層関係を維持し，この階層における誘導を可能にする。一般に，選択されたノードの周囲の文書構造を操作する作業には，TreeWalkersの方が優れており，各々の選択されたノードの内容に焦点を合わせた作業には，NodeIteratorsの方が優れている。

NodeIterators及びTreeWalkersは，各々，部分木で見出されるすべてのノードを含まなくてよい文書部分木のビューを提示する。この規定では，これを論理ビューとして参照し，文書部分木それ自体に対応する物理ビューとは区別する。繰返し子又はTreeWalkerが生成されるとき，各ノードを検査し，それが論理ビューに現れるのが望ましいかどうかを決定するNodeFilterと関連付けられてもよい。さらに，フラグを使用して，どのノード型が論理ビューに現れるのがよいかを指定してもよい。

NodeIterators及びTreeWalkersは，動的とする。すなわち，論理ビューは，基礎となる文書に行われた変更を反映するために変化する。しかし，それらのインタフェースは，その変更にどのように応答するかという点で異なる。ノードを順番に提示するNodeIteratorsは，列の内容が変わる場合，その列の中の位置に対して相対的な位置を維持しようとする。フィルタ処理された木としてノードを提示するTreeWalkersは，現ノードに対して相対的な位置を維持し，新しい文脈に移動する場合には，そのノードに添付された状態を保つ。これらの振る舞いについての詳細を，次に示す。

    NodeIterator iter=
     ((DocumentTraversal)document).createNodeIterator(
          root, NodeFilter.SHOW_ELEMENT, null);

    while (Node n = iter.nextNode())
        printMe(n);
     

 * A B C D E F G H I

 [A] * B C D E F G H I

 * [A] B C D E F G H I

 * [A] B C D E F G H I

A B C [D] * E F G H I

A B C [D] * F G H I

A B C [D] * X F G H I

A B C [D] * I X F G H

A B C [D] * F G H I

A B [C] * F G H I

A B C D * [E] F G H I

A B C D * [F] G H I

A B C [D] * F G H I C

A B [C] * F G H I D

A B * [C]

A [B] *

A B C [D] * E F G H I D

A [B] * G H I D

A [B] * c d E F G

A B c d [E] * F G

A B c [d] * F G

A B c X [d] * F G

    class NamedAnchorFilter implements NodeFilter
    {
     short acceptNode(Node n) {
      if (n.getNodeType()==Node.ELEMENT_NODE) {
       Element e = (Element)n;
       if (! e.getNodeName().equals("A"))
        return FILTER_SKIP;
      if (e.getAttributeNode("NAME") != null)
        return FILTER_ACCEPT;
       }
        return FILTER_SKIP;
      }
    }

NamedAnchorFilter myFilter = new NamedAnchorFilter(); 
NodeIterator iter=
     ((DocumentTraversal)document).createNodeIterator(
          node, NodeFilter.SHOW_ELEMENT, myFilter);
   

processMe(Node n) {
   nodeStartActions(n);
   for (Node child=n.firstChild(); 
        child != null;
        child=child.nextSibling()) {
      processMe(child);
   }
   nodeEndActions(n);
}

processMe(TreeWalker tw) {
   Node n = tw.getCurrentNode();
   nodeStartActions(tw);
   for (Node child=tw.firstChild(); 
        child!=null;
        child=tw.nextSibling()) {
      processMe(tw);
   }

   tw.setCurrentNode(n);
   nodeEndActions(tw);
}

class TablesInChapters implements NodeFilter {

   short acceptNode(Node n) {
      if (n.getNodeType()==Node.ELEMENT_NODE) {
    
          if (n.getNodeName().equals("CHAPTER"))
             return FILTER_ACCEPT;

          if (n.getNodeName().equals("TABLE"))
             return FILTER_ACCEPT;

          if (n.getNodeName().equals("SECT1")
              || n.getNodeName().equals("SECT2")
              || n.getNodeName().equals("SECT3")
              || n.getNodeName().equals("SECT4")
              || n.getNodeName().equals("SECT5")
              || n.getNodeName().equals("SECT6")
              || n.getNodeName().equals("SECT7"))
             return FILTER_SKIP;

      }

      return FILTER_REJECT;
    }
}

TablesInChapters tablesInChapters  = new TablesInChapters();
TreeWalker tw  = 
     ((DocumentTraversal)document).createTreeWalker(
          root, NodeFilter.SHOW_ELEMENT, tablesInChapters);
processMe(tw);

    ...
    <subtree>
        <twRoot>
            <currentNode/>
            <anotherNode/>
        </twRoot>
    </subtree>
    ...
 

    ...
    <subtree>
        <currentNode/>
        <twRoot>
            <anotherNode/>
        </twRoot>
    </subtree>
    ...

1.2 形式的なインタフェース定義

インタフェース NodeIterator (DOM水準2で導入)

Iteratorsは，ノードの集合を通って一つずつ進むために使用される。ここで，ノードの集合とは，例えば，NodeListの中のノードの集合，特別なノードが支配する文書部分木，問合せの結果，又はノードのその他の集合をいう。NodeIteratorの実装によって，繰り返えされるノードの集合が決定される。DOM水準2は，文書部分木の文書順たどりのために，一つのNodeIteratorを規定する。これらの繰返し子のインスタンスは，DocumentTraversal.createNodeIterator()を呼び出すことによって生成される。

IDL定義

// Introduced in DOM Level 2:
interface NodeIterator {
  readonly attribute Node             root;
  readonly attribute unsigned long    whatToShow;
  readonly attribute NodeFilter       filter;
  readonly attribute boolean          expandEntityReferences;
  Node               nextNode()
                                        raises(DOMException);
  Node               previousNode()
                                        raises(DOMException);
  void               detach();
};

属性

型booleanのexpandEntityReferences，読取り専用

このフラグの値は，実体参照ノードの子どもが繰返し子に対して可視かどうかを決定する。falseの場合は，それら及びそれらの子孫は，拒否される。この拒否は，whatToShow及びフィルタに優先することに注意すること。これは，現時点では，NodeIteratorsが，個々のノードを飛ばすのではなくて，完全な部分木を拒否してもよい状況だけとすることにも注意すること。

実体参照を展開して，実体参照ノードそれ自体を開示しない文書のビューを生成するためには，実体参照ノードを隠蔽するようにwhatToShowフラグを使用し，繰返し子を生成するときにexpandEntityReferencesをtrueに設定すること。実体参照ノードをもつが，実体(参照)の展開をもたない文書のビューを生成するためには，実体参照ノードを見せるようにwhatToShowフラグを使用し，expandEntityReferencesをfalseに設定すること。

型NodeFilterのfilter，読取り専用

ノードの選別に使用するNodeFilter。

型Nodeのroot，読取り専用

NodeIteratorが生成された時に指定されたとおりの，NodeIteratorのルートノード。

型unsigned longのwhatToShow，読取り専用

この属性は，繰返し子を介して，どのノード型が提示されるかを決定する。利用可能な定数の集合は，NodeFilterインタフェースにおいて定義される。whatToShowが受諾しないノードは飛ばされるが，その場合でも，それらの子どもは検討されてよい。この飛ばしは，存在する場合には，フィルタに優先する点に注意すること。

メソッド

detach

NodeIteratorをその上で繰り返す集合から切り離し，あらゆる計算中の資源を解放し，繰返し子をINVALID状態にする。detachが呼び出された後，nextNode又はpreviousNodeを呼び出した場合には，例外INVALID_STATE_ERRが挙げられる。

パラメタなし

返却値なし

例外なし

nextNode

集合の中の次のノードを返し，その集合の中の繰返し子の位置を先に進める。NodeIteratorが生成された後，nextNode()の最初の呼出しは，その集合の中の最初のノードを返す。

返却値

Node	その上で繰り返される集合の中の次のNode，又はその集合の中にそれ以上のメンバが存在しない場合は，null。

例外

DOMException

INVALID_STATE_ERR: detachメソッドの呼出し後にこのメソッドが呼び出された場合に，挙げられる。

パラメタなし

previousNode

集合の中の前のノードを返し，その集合の中のNodeIteratorの位置を後退させる。

返却値

Node	その上で繰り返される集合の中の前のNode，又はその集合の中にそれ以上のメンバが存在しない場合には，null。

例外

DOMException

INVALID_STATE_ERR: detachメソッドの呼出し後に，このメソッドが呼び出された場合に，挙げられる。

パラメタなし

インタフェース NodeFilter (DOM水準2で導入)

フィルタは，ノードを"ろ過"する方法を知っているオブジェクトとする。NodeIterator又はTreeWalkerがNodeFilterを提供される場合，次のノードを返す前にフィルタが適用される。フィルタがノードを受諾する場合，たどり論理は，そのノードを返す。そうでない場合は，たどりは次のノードを探し，拒否されたノードがそこに存在しなかったものとして振る舞う。

DOMはフィルタを提供しない。NodeFilterは，単に，利用者が彼ら自身のフィルタを提供するために実装できるインタフェースとする。

NodeFilterは，ノードからノードへのたどり方を知る必要はないし，たどられているデータ構造について何も知る必要もない。これによって，NodeFilterが知る必要があるのは，単一のノードの評価方法だけとなるので，フィルタを書くことが非常に容易になる。一つのフィルタを多くの異なる種類のたどりで使用してもよく，コードの再利用を推奨する。

IDL定義

// Introduced in DOM Level 2:
interface NodeFilter {

  // Constants returned by acceptNode
  const short               FILTER_ACCEPT                  = 1;
  const short               FILTER_REJECT                  = 2;
  const short               FILTER_SKIP                    = 3;


  // Constants for whatToShow
  const unsigned long       SHOW_ALL                       = 0xFFFFFFFF;
  const unsigned long       SHOW_ELEMENT                   = 0x00000001;
  const unsigned long       SHOW_ATTRIBUTE                 = 0x00000002;
  const unsigned long       SHOW_TEXT                      = 0x00000004;
  const unsigned long       SHOW_CDATA_SECTION             = 0x00000008;
  const unsigned long       SHOW_ENTITY_REFERENCE          = 0x00000010;
  const unsigned long       SHOW_ENTITY                    = 0x00000020;
  const unsigned long       SHOW_PROCESSING_INSTRUCTION    = 0x00000040;
  const unsigned long       SHOW_COMMENT                   = 0x00000080;
  const unsigned long       SHOW_DOCUMENT                  = 0x00000100;
  const unsigned long       SHOW_DOCUMENT_TYPE             = 0x00000200;
  const unsigned long       SHOW_DOCUMENT_FRAGMENT         = 0x00000400;
  const unsigned long       SHOW_NOTATION                  = 0x00000800;

  short              acceptNode(in Node n);
};

定義グループ acceptNodeが返す定数

次の定数が，acceptNode()メソッドによって返される。

定義済み定数

FILTER_ACCEPT

ノードを受諾する。NodeIterator又はTreeWalkerのために定義された誘導メソッドは，このノードを返す。

FILTER_REJECT

ノードを拒否する。NodeIterator又はTreeWalkerのために定義された誘導メソッドは，このノードを返さない。TreeWalkerの場合は，このノードの子どもも拒否される。NodeIteratorsは，これをFILTER_SKIPの同義語として扱う。

FILTER_SKIP

この一つのノードを飛ばす。NodeIterator又はTreeWalkerのために定義された誘導メソッドは，このノードを返さない。ただし，NodeIterator及びTreeWalkerの両方について，このノードの子どもは，検討される。

定義グループwhatToShowのための定数

これらは，TreeWalkers及びNodeIteratorsにおいて使用されるwhatToShowパラメタのための利用可能な値とする。それらは，Nodeのために可能な型の集合と同じであって，その値は，等価なノード型についてのnodeTypeの値に対応するビット位置を使用することによって，導出される。whatToShowの中のビットがfalseに設定されている場合，それは，ノードのこの型を飛ばす要求として受け取られる。その場合の振る舞いは，FILTER_SKIPの振る舞いと類似する。

32種類より多いノード型が導入された場合は，whatToShowを介して，それらを個々に検査できないかもしれない点に注意すること。その必要が生じた場合には，適切なNodeFilterと一緒にSHOW_ALLを選択することによって，それを処理できる。

定義済み定数

SHOW_ALL

すべてのNodesを見せる。

SHOW_ATTRIBUTE

Attrノードを見せる。これは，属性ノードをそのrootとしてもつ繰返し子又は木散策を生成する場合だけに，意味がある。この場合，このことは，属性ノードが繰返し又はたどりの最初の位置に現れることを意味する。属性が他のノードの子どもであることはないので，文書木の上をたどるときには，それらが現れることはない。

SHOW_CDATA_SECTION

CDATASectionノードを見せる。

SHOW_COMMENT

Commentノードを見せる。

SHOW_DOCUMENT

Documentノードを見せる。

SHOW_DOCUMENT_FRAGMENT

DocumentFragmentノードを見せる。

SHOW_DOCUMENT_TYPE

DocumentTypeノードを見せる。

SHOW_ELEMENTを見せる。

Elementノードを見せる。

SHOW_ENTITY

Entityノードを見せる。これは，Entityノードをそのrootとしてもつ繰返し子又は木散策を生成する場合だけに，意味がある。この場合，このことは，Entityノードがたどりの最初の位置に現れることを意味する。実体は文書木の一部ではないので，文書木の上をたどるときに，それらが現れることはない。

SHOW_ENTITY_REFERENCE

EntityReferenceノードを見せる。

SHOW_NOTATION

Notationノードを見せる。これは，Notationノードをそのrootとしてもつ繰返し子又は木散策を生成する場合だけに，意味がある。この場合，このことは，Notationノードがたどりの最初の位置に現れることを意味する。記法は文書木の一部ではないので，文書木の上をたどるときに，それらが現れることはない。

SHOW_PROCESSING_INSTRUCTION

ProcessingInstructionノードを見せる。

SHOW_TEXT

Textノードを見せる。

メソッド

acceptNode

指定されたノードがTreeWalker又はNodeIteratorの論理ビューで可視かどうかを試験する。この関数は，TreeWalker及びNodeIteratorの実装によって呼び出される。これは，通常，利用者コードから直接に呼び出されることはない。ただし，同じフィルタを使用して，利用者自身のアプリケーション論理を導きたい場合には，利用者コードから直接に呼び出すことは可能とする。

パラメタ

型Nodeのn

フィルタを通過するかしないかを調べるために検査を行うノード。

返却値

short

"定義グループ acceptNodeが返す定数"で定義されるとおりに，ノードが受諾されるか，拒否されるか，又は飛ばされるかを決定する定数。

例外なし

インタフェース TreeWalker (DOM水準2で導入)

TreeWalkerオブジェクトは，そのwhatToShowフラグ及び(存在する場合には)フィルタが定義する文書のビューを使用して，文書木又は部分木を誘導するために使用する。TreeWalkerを使用して誘導を実行するあらゆる関数は，自動的に，TreeWalkerが定義するあらゆるビューをサポートする。

部分木の論理ビューからのノードを省略することは，結果として，フィルタにかけていない完全な文書の同じ部分木とは実質的に異なる構造になる。TreeWalkerビューの中で兄弟であるノードが，元のビューの中では，異なる，非常に離れたノードの子であってもよい。例えば，文書のテキストノード及びルートノードを除くすべてのノードを飛ばすNodeFilterを考えてみる。その結果として得られる論理ビューの中では，すべてのテキストノードは，兄弟となり，元の文書の構造がどんなに深く入れ子になっていても，ルートノードの直接の子どもとして現れることになる。

IDL定義

// Introduced in DOM Level 2:
interface TreeWalker {
  readonly attribute Node             root;
  readonly attribute unsigned long    whatToShow;
  readonly attribute NodeFilter       filter;
  readonly attribute boolean          expandEntityReferences;
           attribute Node             currentNode;
                                        // raises(DOMException) on setting

  Node               parentNode();
  Node               firstChild();
  Node               lastChild();
  Node               previousSibling();
  Node               nextSibling();
  Node               previousNode();
  Node               nextNode();
};

属性

型NodeのcurrentNode

TreeWalkerが現在位置しているノード。
DOM木への変更によって，現ノードを，TreeWalkerの関連するフィルタがもはや受諾しなくなることがある。currentNodeは，それがrootノードが指定する部分木内に存在するかしないか，又はフィルタ及びwhatToShowフラグによって受諾されるかどうかに関わらず，すべてのノードに対して明示的に設定されてもよい。currentNodeが，要求された方向でフィルタが適用されることによって，現在ビューの一部ではない場合であっても，更なるたどりが，currentNodeに相対的に発生する。たどりが可能ではない場合，currentNodeは，変更されない。

設定に関する例外

DOMException

NOT_SUPPORTED_ERR: currentNodeをnullに設定しようと試みた場合に，挙げられる。

型booleanのexpandEntityReferences，読取り専用

このフラグの値は，実体参照ノードの子どもがTreeWalkerに対して可視かどうかを決定する。falseの場合は，それら及びそれらの子孫は，拒否される。この拒否は，whatToShow及び(存在する場合には)フィルタに優先する点に注意すること。
実体参照が展開され，実体参照ノードそれ自体を開示しない文書のビューを生成するためには，実体参照ノードを隠蔽するようにwhatToShowフラグを使用し，TreeWalkerの生成するときにexpandEntityReferencesをtrueに設定すること。実体参照ノードをもつが，実体展開をもたない文書のビューを生成するためには，実体参照ノードを見せるようにwhatToShowフラグを使用し，expandEntityReferencesをfalseに設定すること。

型NodeFilterのfilter，読取り専用

ノードの選別に使用されるフィルタ。

型Nodeのroot，読取り専用

生成時に指定されるとおりの，TreeWalkerのrootノード。

型unsigned longのwhatToShow，読取り専用

この属性は，どのノード型がTreeWalkerを介して提示されるかを決定する。利用可能な定数の集合は，NodeFilterインタフェースの中で定義される。whatToShowが受諾しないノードは飛ばされるが，その場合でも，それらの子どもは検討される。この飛ばしは，(存在する場合には)フィルタに優先する点に注意すること。

メソッド

firstChild

TreeWalkerを現ノードの最初の可視の子まで移動し，その新しいノードを返す。現ノードに可視の子どもがない場合は，nullを返し，現ノードを保持する。

返却値

Node	新しいノード，又は現ノードがTreeWalkerの論理ビューの中で可視の子どもをもたない場合は，null。

パラメタなし

例外なし

lastChild

TreeWalkerを現ノードの最後の可視の子まで移動し，その新しいノードを返す。現ノードに可視の子どもがない場合は，nullを返し，現ノードを保持する。

返却値

Node	新しいノード，又は現ノードがTreeWalkerの論理ビューの中で子どもをもたない場合は，null。

パラメタなし

例外なし

nextNode

TreeWalkerを，現ノードに相対的な文書順で次の可視のノードまで移動し，その新しいノードを返す。現ノードに次のノードがない場合，又はnextNodeの検索がTreeWalkerのrootノードから上に移動しようとした場合は，nullを返し，現ノードを保持する。

返却値

Node	新しいノード，又は現ノードがTreeWalkerの論理ビューの中で次のノードをもたない場合は，null。

パラメタなし

例外なし

nextSibling

TreeWalkerを現ノードの次の兄弟まで移動し，その新しいノードを返す。現ノードに可視の次の兄弟がない場合は，nullを返し，現ノードを保持する。

返却値

Node	新しいノード，又は現ノードがTreeWalkerの論理ビューの中で次の兄弟をもたない場合は，null。

パラメタなし

例外なし

parentNode

現ノードの最も近い可視の先祖ノードまで移動し，それを返す。parentNodeの検索がTreeWalkerのrootノードから上に移動しようとした場合，又は可視の先祖ノードの発見に失敗した場合は，このメソッドは，現在の位置を保持し，nullを返す。

返却値

Node	新しい親ノード，又は現ノードがTreeWalkerの論理ビューの中で親をもたない場合は，null。

パラメタなし

例外なし

previousNode

TreeWalkerを，現ノードに相対的な文書順で前の可視のノードに移動し，その新しいノードを返す。現ノードに前のノードがない場合，又はpreviousNodeの検索がTreeWalkerのrootノードから上に移動しようとした場合は，nullを返し，現ノードを保持する。

返却値

Node	新しいノード，又は現ノードがTreeWalkerの論理ビューの中で前のノードをもたない場合は，null。

パラメタなし

例外なし

previousSibling

TreeWalkerを現ノードの前の兄弟まで移動し，その新しいノードを返す。現ノードに可視の前の兄弟がいない場合は，nullを返し，現ノードを保持する。

返却値

Node	新しいノード，又は現ノードがTreeWalkerの論理ビューの中で前の兄弟をもたない場合は，null。

パラメタなし

例外なし

インタフェース DocumentTraversal (DOM水準2で導入)

DocumentTraversalは，繰返し子，並びにノード及びその子どもを文書順でたどる木散策を生成するメソッドを含む。ここでいう文書順とは，深さの方向を最初にする前順たどりであって，文書のテキスト表現で開始タグが現れる順番と等価になっている。Traversal(たどり)機能をサポートするDOMでは，DocumentTraversalは，Documentインタフェースを実装する同じオブジェクトによって，実装される。

IDL定義

// Introduced in DOM Level 2:
interface DocumentTraversal {
  NodeIterator       createNodeIterator(in Node root, 
                                        in unsigned long whatToShow, 
                                        in NodeFilter filter, 
                                        in boolean entityReferenceExpansion)
                                        raises(DOMException);
  TreeWalker         createTreeWalker(in Node root, 
                                      in unsigned long whatToShow, 
                                      in NodeFilter filter, 
                                      in boolean entityReferenceExpansion)
                                        raises(DOMException);
};

メソッド

createNodeIterator

指定されたノードをルートとする部分木の上に，新しいNodeIteratorを生成する。

パラメタ

型Nodeのroot

その子どもと一緒に繰り返されるノード。繰返し子は，最初に，このノードの直前に配置される。この位置設定のとき，whatToShowフラグ及び(存在する場合には)フィルタは考慮されない。ルートは，nullであってはならない。

型unsigned longのwhatToShow

このフラグは，繰返し子が提示する木の論理ビューの中にどのノード型が現れてよいかを指定する。可能なSHOW_値の集合については，NodeFilterの記述を参照すること。
ORを使用して，これらのフラグを組み合わせることができる。

型NodeFilterのfilter

このTreeWalkerと一緒に使用されるNodeFilter，又はフィルタが存在しないことを示すnull。

型booleanのentityReferenceExpansion

このフラグの値は，実体参照ノードが展開されるかどうかを決定する。

返却値

NodeIterator

新しく生成されたNodeIterator。

例外

DOMException

NOT_SUPPORTED_ERR: 指定されたrootがnullの場合に，挙げられる。

createTreeWalker

指定されたノードをルートとする部分木の上に，新しいTreeWalkerを生成する。

パラメタ

型Nodeのroot

TreeWalkerに対してrootとして振る舞うノード。whatToShowフラグ及びNodeFilterは，この値の設定時には考慮されない。すなわち，あらゆるノード型が，rootとして受諾される。TreeWalkerのcurrentNodeは，可視かどうかに関係なく，このノードに対して初期化される。rootは，parentNode及びnextNodeといった文書構造の中を上方向に検索するたどりメソッドのための停止位置として機能する。rootは，nullであってはならない。

型unsigned longのwhatToShow

このフラグは，木散策が提示する木の論理ビューの中にどのノード型が現れてよいかを指定する。可能なSHOW_値の集合については，NodeFilterの記述を参照すること。
ORを使用して，これらのフラグを組み合わせることができる。

型NodeFilterのfilter

このTreeWalkerと一緒に使用されるNodeFilter，又はフィルタが存在しないことを示すnull。

型booleanのentityReferenceExpansion

このフラグがfalseの場合，EntityReferenceノードの内容は，論理ビューの中で提示されない。

返却値

TreeWalker

新しく生成されたTreeWalker。

例外

DOMException

NOT_SUPPORTED_ERR: 指定されたrootがnullの場合に，挙げられる。