Document.createTreeWalker()
===========================

**`Document.createTreeWalker()`** 메소드는 새로운 `TreeWalker` 객체를 반환합니다.

구문
--


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

### 매개변수

`root`

이 `TreeWalker` 순회의 루트 `Node` (en-US)이다. 이것은 보통 이 문서 소유의 한 엘리먼트이다.

`whatToShow` Optional

`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` (en-US) 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` (en-US) 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` (en-US) nodes. |
| `NodeFilter.SHOW_TEXT` | `4` | Shows `Text` nodes. |

`filter` Optional

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

`entityReferenceExpansion` Optional 
지원이 중단되었습니다

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

### 반환 값

새로운 `TreeWalker` 객체.

예제
--

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


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

명세
--

| Specification |
| --- |
| DOM Standard # dom-document-createtreewalker |

브라우저 호환성
--------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

참고
--

* 생성하는 객체의 인터페이스: `TreeWalker`.
* createTreeWalker on MSDN