Document.createTreeWalker()

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.createTreeWalker() 메소드는 새로운TreeWalker 객체를 반환합니다.

구문

document.createTreeWalker(root, whatToShow[, filter[, entityReferenceExpansion]]);

매개변수

root

이TreeWalker 순회의 루트Node이다. 이것은 보통 이 문서 소유의 한 엘리먼트이다.

whatToShowOptional

NodeFilter의 상수 프라퍼티들을 조합하여 만든 비트마스크를 나타내는 선택적인unsigned long 이다. 이것은 특정 유형의 노드를 필터링하는 편리한 방법이다. 기본값은SHOW_ALL 상수를 나타내는0xFFFFFFFF이다.

상수	숫자 값	설명
`NodeFilter.SHOW_ALL`	`-1` (`unsigned long의 최대 값`)	Shows all nodes.
`NodeFilter.SHOW_ATTRIBUTE`지원이 중단되었습니다	`2`	Shows attribute`Attr` nodes. This is meaningful only when creating a`TreeWalker` with an`Attr` node as its root; in this case, it means that the attribute node will appear in the first position of the iteration or traversal. Since attributes are never children of other nodes, they do not appear when traversing over the document tree.
`NodeFilter.SHOW_CDATA_SECTION`지원이 중단되었습니다	`8`	Shows`CDATASection` nodes.
`NodeFilter.SHOW_COMMENT`	`128`	Shows`Comment` nodes.
`NodeFilter.SHOW_DOCUMENT`	`256`	Shows`Document` nodes.
`NodeFilter.SHOW_DOCUMENT_FRAGMENT`	`1024`	Shows`DocumentFragment` nodes.
`NodeFilter.SHOW_DOCUMENT_TYPE`	`512`	Shows`DocumentType` nodes.
`NodeFilter.SHOW_ELEMENT`	`1`	Shows`Element` nodes.
`NodeFilter.SHOW_ENTITY`지원이 중단되었습니다	`32`	Shows`Entity` nodes. This is meaningful only when creating a`TreeWalker` with an`Entity` node as its root; in this case, it means that the`Entity` node will appear in the first position of the traversal. Since entities are not part of the document tree, they do not appear when traversing over the document tree.
`NodeFilter.SHOW_ENTITY_REFERENCE`지원이 중단되었습니다	`16`	Shows`EntityReference` nodes.
`NodeFilter.SHOW_NOTATION`지원이 중단되었습니다	`2048`	Shows`Notation` nodes. This is meaningful only when creating a`TreeWalker` with a`Notation` node as its root; in this case, it means that the`Notation` node will appear in the first position of the traversal. Since entities are not part of the document tree, they do not appear when traversing over the document tree.
`NodeFilter.SHOW_PROCESSING_INSTRUCTION`	`64`	Shows`ProcessingInstruction` nodes.
`NodeFilter.SHOW_TEXT`	`4`	Shows`Text` nodes.

filterOptional

선택적인NodeFilter이다.TreeWalker가whatToShow 체크를 통과한 노드의 승인여부를 판단하기 위해 호출하는acceptNode 메소드를 가진 객체이다.

entityReferenceExpansionOptional 지원이 중단되었습니다

한EntityReference를 버릴 때 그 전체 하위 트리를 같이 버려야하는지를 나타내는Boolean 플래그이다.

반환 값

새로운TreeWalker 객체.

예제

다음 예제는 body의 모든 노드들을 순회하고, 노드의 집합을 엘리먼트로 줄이고, 단순히 각 노드를 승인하고 (대신acceptNode() 메소드에서 그 집합을 줄일 수도 있다), 노드들(지금은 모두 엘리먼트지만)을 전진하기 위해 생성된 트리 워커 반복자를 이용하여 배열에 푸시한다.

var treeWalker = document.createTreeWalker(  document.body,  NodeFilter.SHOW_ELEMENT,  {    acceptNode: function (node) {      return NodeFilter.FILTER_ACCEPT;    },  },  false,);var nodeList = [];while (treeWalker.nextNode()) nodeList.push(treeWalker.currentNode);