1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
|
---
title: Document
slug: Web/API/Document
tags:
- API
- DOM
- Document
- Interface
- Reference
translation_of: Web/API/Document
---
<div>{{APIRef("DOM")}}</div>
<p><span class="seoSummary"><strong><code>Document</code></strong> 인터페이스는 브라우저가 불러온 웹 페이지를 나타내며, 페이지 콘텐츠(<a href="/ko/docs/Web/API/Document_object_model/Using_the_W3C_DOM_Level_1_Core">DOM 트리</a>)의 진입점 역할을 수행합니다.</span> DOM 트리는 {{HTMLElement("body")}}와 {{HTMLElement("table")}} 및 <a href="https://developer.mozilla.org/ko/docs/Web/HTML/Element">여러 다른</a> 요소를 포함합니다. <code>Document</code>는 페이지의 URL을 얻거나 문서에 새로운 요소를 생성하는 등의 기능을 전역적으로 제공합니다.</p>
<p>{{inheritanceDiagram}}</p>
<p><code>Document</code> 인터페이스는 모든 종류의 문서에 대한 공통의 속성과 메서드를 묘사합니다. 문서의 유형(<a href="/ko/docs/Web/HTML">HTML</a>, <a href="/ko/docs/Web/XML/XML_introduction">XML</a>, SVG 등)에 따라서 더 다양한 API가 존재합니다. 예컨대 <code>"text/html"</code> 콘텐츠 유형으로 제공되는 HTML 문서는 {{domxref("HTMLDocument")}} 인터페이스도 구현하는 반면, XML과 SVG 문서는 {{domxref("XMLDocument")}} 인터페이스를 구현합니다.</p>
<h2 id="생성자">생성자</h2>
<dl>
<dt>{{domxref("Document.Document","Document()")}} {{non-standard_inline}}</dt>
<dd>새로운 <code>Document</code> 객체를 생성합니다.</dd>
</dl>
<h2 id="Properties" name="Properties">속성</h2>
<p><em><code>Documet</code>는 {{domxref("Node")}}와 {{domxref("EventTarget")}} 인터페이스도 상속합니다.</em></p>
<dl>
<dt>{{domxref("Document.anchors")}} {{readonlyinline}}</dt>
<dd>문서 내 모든 앵커의 목록을 반환합니다.</dd>
<dt>{{domxref("Document.body")}}</dt>
<dd>현재 문서의 {{HTMLElement("body")}} 또는 {{htmlelement("frameset")}} 노드를 반환합니다.</dd>
<dt>{{domxref("Document.characterSet")}} {{readonlyinline}}</dt>
<dd>문서에서 사용하는 캐릭터셋을 반환합니다.</dd>
<dt>{{domxref("Document.compatMode")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>문서의 렌더링 모드가 Quirks와 Strict 중 어떤 것인지 반환합니다.</dd>
<dt>{{domxref("Document.contentType")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>현재 문서의 MIME 헤더로부터 <code>Content-Type</code>을 반환합니다.</dd>
<dt>{{domxref("Document.doctype")}} {{readonlyinline}}</dt>
<dd>현재 문서의 문서 형식 정의(Document Type Definition, DTD)를 반환합니다.</dd>
<dt>{{domxref("Document.documentElement")}} {{readonlyinline}}</dt>
<dd>문서의 직속 자식인 {{domxref("Element")}}를 반환합니다. HTML 문서에서는 보통 {{HTMLElement("html")}} 요소를 나타내는 {{domxref("HTMLHtmlElement")}} 객체입니다.</dd>
<dt>{{domxref("Document.documentURI")}} {{readonlyinline}}</dt>
<dd>문서의 위치를 문자열로 반환합니다.</dd>
<dt>{{domxref("Document.embeds")}} {{readonlyinline}}</dt>
<dd>현재 문서에 포함된 {{HTMLElement("embed")}} 요소 목록을 반환합니다.</dd>
<dt>{{domxref("Document.fonts")}}</dt>
<dd>현재 문서의 {{domxref("FontFaceSet")}} 인터페이스를 반환합니다.</dd>
<dt>{{domxref("Document.forms")}} {{readonlyinline}}</dt>
<dd>현재 문서의 {{HTMLElement("form")}} 요소 목록을 반환합니다.</dd>
<dt>{{domxref("Document.head")}} {{readonlyinline}}</dt>
<dd>현재 문서의 {{HTMLElement("head")}} 요소를 반환합니다.</dd>
<dt>{{domxref("Document.hidden")}} {{readonlyinline}}</dt>
<dd>현재 문서의 숨김 여부를 반환합니다.</dd>
<dt>{{domxref("Document.images")}} {{readonlyinline}}</dt>
<dd>현재 문서의 이미지 목록을 반환합니다.</dd>
<dt>{{domxref("Document.implementation")}} {{readonlyinline}}</dt>
<dd>현재 문서와 연관된 DOM 구현을 반환합니다.</dd>
<dt>{{domxref("Document.lastStyleSheetSet")}} {{readonlyinline}}</dt>
<dd>마지막에 활성화된 스타일 시트 세트의 이름을 반환합니다. {{domxref("Document.selectedStyleSheetSet","selectedStyleSheetSet")}} 값을 설정하여 스타일 시트가 변경되기 전에는 <code>null</code> 값을 갖습니다.</dd>
<dt>{{domxref("Document.links")}} {{readonlyinline}}</dt>
<dd>문서의 모든 하이퍼링크 목록을 반환합니다.</dd>
<dt>{{domxref("Document.mozSyntheticDocument")}} {{non-standard_inline}}</dt>
<dd>문서가 synthetic, 즉 단일 이미지, 비디오, 오디오 파일이나 이와 비슷한 것인 경우 {{jsxref("Boolean")}} <code>true</code>를 반환합니다.</dd>
<dt>{{domxref("Document.plugins")}} {{readonlyinline}}</dt>
<dd>사용 가능한 플러그인의 목록을 반환합니다.</dd>
<dt>{{domxref("Document.policy")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>특정 문서에 적용되는 기능 정책을 자성하기 위한 간단한 API 를 제공하는 {{domxref("Policy")}} 인터페이스를 반환합니다.</dd>
<dt>{{domxref("Document.preferredStyleSheetSet")}} {{readonlyinline}}</dt>
<dd>페이지 작성자가 지정한 선호 스타일 시트 세트를 반환합니다.</dd>
<dt>{{domxref("Document.scripts")}} {{readonlyinline}}</dt>
<dd>문서의 모든 {{HTMLElement("script")}} 요소를 반환합니다.</dd>
<dt>{{domxref("Document.scrollingElement")}} {{readonlyinline}}</dt>
<dd>문서를 스크롤 하는 {{domxref("Element")}}에 대한 참조를 반환합니다.</dd>
<dt>{{domxref("Document.selectedStyleSheetSet")}}</dt>
<dd>현재 사용 중인 스타일 시트 세트를 반환합니다.</dd>
<dt>{{domxref("Document.styleSheetSets")}} {{readonlyinline}}</dt>
<dd>문서에서 사용 가능한 스타일 시트 세트의 목록을 반환합니다.</dd>
<dt>{{domxref("Document.timeline")}} {{readonlyinline}}</dt>
<dd>페이지 로드 시 자동으로 생성하는 {{domxref("DocumentTimeline")}}의 인스턴스를 반환합니다.</dd>
<dt>{{domxref("Document.undoManager")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>…</dd>
<dt>{{domxref("Document.visibilityState")}} {{readonlyinline}}</dt>
<dd>문서의 표시 상태를 나타내는 문자열을 반환합니다. 가능한 값은 <code>visible</code>, <code>hidden</code>, <code>prerender</code>, <code>unloaded</code>입니다.</dd>
</dl>
<p><code>Document</code> 인터페이스는 {{domxref("ParentNode")}} 인터페이스를 확장합니다.</p>
<p>{{page("/ko/docs/Web/API/ParentNode","속성")}}</p>
<h3 id="HTMLDocument_확장">HTMLDocument 확장</h3>
<p>HTML 문서를 위한 <code>Document</code> 인터페이스는 HTML5 이전엔 {{domxref("HTMLDocument")}} 인터페이스를 상속하고, 이후로는 확장합니다.</p>
<dl>
<dt>{{domxref("Document.cookie")}}</dt>
<dd>문서의 쿠키 리스트를 세미콜론으로 분리해 반환하거나, 하나의 쿠키를 설정합니다.</dd>
<dt>{{domxref("Document.defaultView")}} {{readonlyinline}}</dt>
<dd>{{domxref("Window")}} 객체의 참조를 반환합니다.</dd>
<dt>{{domxref("Document.designMode")}}</dt>
<dd>문서 전체의 수정 가능 여부를 설정/반환합니다.</dd>
<dt>{{domxref("Document.dir")}}</dt>
<dd>문서의 쓰기 방향(rtl/ltr)을 설정/반환합니다.</dd>
<dt>{{domxref("Document.domain")}}</dt>
<dd>현재 문서의 도메인을 설정/반환합니다.</dd>
<dt>{{domxref("Document.lastModified")}} {{readonlyinline}}</dt>
<dd>문서가 마지막으로 수정된 날짜를 반환합니다.</dd>
<dt>{{domxref("Document.location")}} {{readonlyinline}}</dt>
<dd>현재 문서의 URI를 반환합니다.</dd>
<dt>{{domxref("Document.readyState")}} {{readonlyinline}}</dt>
<dd>문서의 불러오기 상태를 반환합니다.</dd>
<dt>{{domxref("Document.referrer")}} {{readonlyinline}}</dt>
<dd>현재 페이지로 연결한 페이지의 URI를 반환합니다.</dd>
<dt>{{domxref("Document.title")}}</dt>
<dd>문서의 제목을 설정하거나 반환합니다.</dd>
<dt>{{domxref("Document.URL")}} {{readonlyInline}}</dt>
<dd>문서의 위치를 문자열로 반환합니다.</dd>
</dl>
<h3 id="DocumentOrShadowRoot에서_포함한_속성">DocumentOrShadowRoot에서 포함한 속성</h3>
<p><code>Document</code> 인터페이스는 {{domxref("DocumentOrShadowRoot")}} 믹스인이 정의하는 다음의 속성을 포함합니다. 지금은 Chrome만 <code>DocumentOrShadowRoot</code> 믹스인으로 구현한 상태라는 점에 유의하세요. 다른 브라우저는 <code>Document</code> 인터페이스에 직접 구현합니다.</p>
<dl>
<dt>{{domxref("DocumentOrShadowRoot.activeElement")}} {{readonlyInline}}</dt>
<dd>섀도 트리 내에서 포커스를 가진 {{domxref('Element')}} 를 반환합니다.</dd>
<dt>{{domxref("Document.fullscreenElement")}} {{readonlyinline}}</dt>
<dd>현재 문서에서 전체 화면 모드 중인 요소를 반환합니다.</dd>
<dt>{{domxref("DocumentOrShadowRoot.pointerLockElement")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>포인터가 잠긴 동안 마우스 이벤트의 대상으로 설정한 요소를 반환합니다. 잠금 대기 중이거나, 포인터의 잠금이 해제됐거나, 대상이 다른 문서에 존재하는 경우 <code>null</code>입니다.</dd>
<dt>{{domxref("DocumentOrShadowRoot.styleSheets")}} {{readonlyInline}}</dt>
<dd>문서가 포함하거나 명시적으로 연결한 스타일 시트를 나타내는, {{domxref("CSSStyleSheet")}}의 {{domxref("StyleSheetList")}} 객체를 반환합니다.</dd>
</dl>
<h3 id="Event_handlers" name="Event_handlers">이벤트 처리기</h3>
<dl>
<dt>{{domxref("Document.onafterscriptexecute")}} {{non-standard_inline}}</dt>
<dd>{{event("afterscriptexecute")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
<dt>{{domxref("Document.onbeforescriptexecute")}} {{non-standard_inline}}</dt>
<dd>{{event("beforescriptexecute")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
<dt>{{domxref("Document.oncopy")}} {{non-standard_inline}}</dt>
<dd>{{event("copy")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
<dt>{{domxref("Document.oncut")}} {{non-standard_inline}}</dt>
<dd>{{event("cut")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
<dt>{{domxref("Document.onfullscreenchange")}}</dt>
<dd>{{event("fullscreenchange")}} 이벤트가 발생할 때 호출되는 코드를 나타내는 {{domxref("EventHandler")}} 입니다.</dd>
<dt>{{domxref("Document.onfullscreenerror")}}</dt>
<dd>{{event("fullscreenerror")}} 이벤트가 발생할 때 호출되는 코드를 나타내는 {{domxref("EventHandler")}} 입니다.</dd>
<dt>{{domxref("Document.onpaste")}} {{non-standard_inline}}</dt>
<dd>{{event("paste")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
<dt>{{domxref("Document.onreadystatechange")}}</dt>
<dd>{{event("readystatechange")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
<dt>{{domxref("Document.onselectionchange")}} {{experimental_inline}}</dt>
<dd>{{event("selectionchange")}} 이벤트가 발생할 때 호출되는 코드를 나타내는 {{domxref("EventHandler")}} 입니다.</dd>
<dt>{{domxref("Document.onvisibilitychange")}}</dt>
<dd>{{event("visibilitychange")}} 이벤트가 발생할 때 호출되는 코드를 나타내는 {{domxref("EventHandler")}} 입니다.</dd>
</dl>
<p><code>Document</code> 인터페이스는 {{domxref("GlobalEventHandlers")}} 인터페이스를 확장합니다.</p>
<p>{{Page("/ko/docs/Web/API/GlobalEventHandlers", "속성")}}</p>
<h3 id="사용하지_않는_속성">사용하지 않는 속성</h3>
<dl>
<dt>{{domxref("Document.alinkColor")}} {{Deprecated_inline}}</dt>
<dd>다큐먼트 바디에 있는 활성 링크의 색상을 설정하거나 반환합니다.</dd>
<dt>{{domxref("Document.all")}} {{Deprecated_inline}} {{non-standard_inline}}</dt>
<dd>다큐먼트의 모든 엘리먼트로의 접근을 제공합니다. 레거시이며 비표준 속성이므로 사용되면 안됩니다.</dd>
<dt>{{domxref("Document.applets")}} {{Deprecated_inline}} {{readonlyinline}}</dt>
<dd>다큐먼트에 있는 애플릿의 정렬된 리스트를 반환합니다.</dd>
<dt>{{domxref("Document.async")}} {{Deprecated_inline}}</dt>
<dd>{{domxref("Document.load")}} 와 사용되어 비동기 요청을 나타냅니다.</dd>
<dt>{{domxref("Document.bgColor")}} {{Deprecated_inline}}</dt>
<dd>현재 다큐먼트의 배경 색상을 설정하거나 반환합니다.</dd>
<dt>{{domxref("Document.charset")}} {{readonlyinline}} {{Deprecated_inline}}</dt>
<dd>{{domxref("Document.characterSet")}} 과 동일합니다. {{domxref("Document.characterSet")}} 속성을 사용하시기 바랍니다.</dd>
<dt>{{domxref("Document.domConfig")}} {{Deprecated_inline}}</dt>
<dd>{{domxref("DOMConfiguration")}} 객체를 반환합니다.</dd>
<dt>{{domxref("document.fgColor")}} {{Deprecated_inline}}</dt>
<dd>현재 다큐먼트의 foreground 색상이나 텍스트 색상을 설정하거나 반환합니다.</dd>
<dt>{{domxref("Document.fullscreen")}} {{obsolete_inline}}</dt>
<dd>다큐먼트가 {{domxref("Using_full-screen_mode","full-screen mode")}}에 있을 때 <code>true</code> 를 반환합니다.</dd>
<dt>{{domxref("Document.height")}} {{non-standard_inline}} {{obsolete_inline}}</dt>
<dd>현재 다큐먼트의 높이를 설정하거나 반환합니다.</dd>
<dt>{{domxref("Document.inputEncoding")}} {{readonlyinline}} {{Deprecated_inline}}</dt>
<dd>{{domxref("Document.characterSet")}} 과 동일합니다. {{domxref("Document.characterSet")}} 속성을 사용하시기 바랍니다.</dd>
<dt>{{domxref("Document.linkColor")}} {{Deprecated_inline}}</dt>
<dd>다큐먼트내 하이퍼링크의 색상을 설정하거나 반환합니다.</dd>
<dt>{{domxref("Document.vlinkColor")}} {{Deprecated_inline}}</dt>
<dd>방문한 하이퍼링크의 색상을 설정하거나 반환합니다.</dd>
<dt>{{domxref("Document.width")}} {{non-standard_inline}} {{obsolete_inline}}</dt>
<dd>현재 다큐먼트의 너비를 반환합니다.</dd>
<dt>{{domxref("Document.xmlEncoding")}} {{Deprecated_inline}}</dt>
<dd>XML 선언으로 결정된 인코딩을 반환합니다.</dd>
<dt>{{domxref("Document.xmlStandalone")}} {{obsolete_inline("10.0")}}</dt>
<dd>XML 선언이 다큐먼트를 독립되도록 지정하면 <code>true</code> 를(<em>예,</em> DTD 의 외부가 다큐먼트의 컨텐츠에 영향을 줌), 그렇지 않은 경우 <code>false</code> 를 반환합니다.</dd>
<dt>{{domxref("Document.xmlVersion")}} {{obsolete_inline("10.0")}}</dt>
<dd>XML 선언에 명시된 버전 넘버를 반환합니다. 선언에 명시되어 있지 않은 경우, <code>"1.0"</code> 을 반환합니다.</dd>
</dl>
<h2 id="Methods" name="Methods">메서드</h2>
<p><em><code>Documet</code>는 {{domxref("Node")}}와 {{domxref("EventTarget")}} 인터페이스도 상속합니다.</em></p>
<dl>
<dt>{{domxref("Document.adoptNode()")}}</dt>
<dd>외부 문서로부터 노드를 가져옵니다.</dd>
<dt>{{domxref("Document.captureEvents()")}} {{Deprecated_inline}}</dt>
<dd>{{domxref("Window.captureEvents")}}를 확인하세요.</dd>
<dt>{{domxref("Document.caretRangeFromPoint()")}}{{non-standard_inline}}</dt>
<dd>지정한 좌표에 위치한 문서 프래그먼트에 대한 {{domxref("Range")}} 객체를 반환합니다.</dd>
<dt>{{domxref("Document.createAttribute()")}}</dt>
<dd>새로운 {{domxref("Attr")}} 객체를 생성하고 반환합니다.</dd>
<dt>{{domxref("Document.createAttributeNS()")}}</dt>
<dd>주어진 네임스페이스에 새로운 속성 노드를 생성하고 반환합니다.</dd>
<dt>{{domxref("Document.createCDATASection()")}}</dt>
<dd>새로운 CDATA 노드를 생성하고 반환합니다.</dd>
<dt>{{domxref("Document.createComment()")}}</dt>
<dd>새로운 주석 노드를 생성하고 반환합니다.</dd>
<dt>{{domxref("Document.createDocumentFragment()")}}</dt>
<dd>새로운 문서 조각을 생성합니다.</dd>
<dt>{{domxref("Document.createElement()")}}</dt>
<dd>주어진 태그명을 사용해 새로운 요소를 생성합니다.</dd>
<dt>{{domxref("Document.createElementNS()")}}</dt>
<dd>주어진 태그명과 네임스페이스 URI를 갖는 새로운 요소를 생성합니다.</dd>
<dt>{{domxref("Document.createEntityReference()")}} {{obsolete_inline}}</dt>
<dd>새로운 개체 참조를 생성하고 반환합니다.</dd>
<dt>{{domxref("Document.createEvent()")}}</dt>
<dd>이벤트 객체를 생성합니다.</dd>
<dt>{{domxref("Document.createNodeIterator()")}}</dt>
<dd>{{domxref("NodeIterator")}} 객체를 생성합니다.</dd>
<dt>{{domxref("Document.createProcessingInstruction()")}}</dt>
<dd>새로운 {{domxref("ProcessingInstruction")}} 객체를 생성합니다.</dd>
<dt>{{domxref("Document.createRange()")}}</dt>
<dd>{{domxref("Range")}} 객체를 생성합니다.</dd>
<dt>{{domxref("Document.createTextNode()")}}</dt>
<dd>텍스트 노드를 생성합니다.</dd>
<dt>{{domxref("Document.createTouch()")}} {{Deprecated_inline}}</dt>
<dd>{{domxref("Touch")}} 객체를 생성합니다.</dd>
<dt>{{domxref("Document.createTouchList()")}}</dt>
<dd>{{domxref("TouchList")}} 객체를 생성합니다.</dd>
<dt>{{domxref("Document.createTreeWalker()")}}</dt>
<dd>{{domxref("TreeWalker")}} 객체를 생성합니다.</dd>
<dt>{{domxref("Document.enableStyleSheetsForSet()")}}</dt>
<dd>지정한 스타일 시트 세트의 스타일 시트를 활성화합니다.</dd>
<dt>{{domxref("Document.exitPointerLock()")}} {{experimental_inline}}</dt>
<dd>포인터 잠금을 해제합니다.</dd>
<dt>{{domxref("Document.getAnimations()")}} {{experimental_inline}}</dt>
<dd>문서의 자손 요소를 대상으로 하고, 현재 실행 중인 모든 {{domxref("Animation")}} 객체를 배열로 반환합니다.</dd>
<dt>{{domxref("Document.getElementsByClassName()")}}</dt>
<dd>주어진 클래스 이름을 갖는 요소의 목록을 반환합니다.</dd>
<dt>{{domxref("Document.getElementsByTagName()")}}</dt>
<dd>주어진 태그명을 갖는 요소의 목록을 반환합니다.</dd>
<dt>{{domxref("Document.getElementsByTagNameNS()")}}</dt>
<dd>주어진 태그명과 네임스페이스를 갖는 요소의 목록을 반환합니다.</dd>
<dt>{{domxref("Document.hasStorageAccess()")}}</dt>
<dd>문서가 퍼스트파티<sup>first-party</sup> 저장소에 접근할 수 있는지 나타내는 {{jsxref("Boolean")}}으로 이행하는 {{jsxref("Promise")}}를 반환합니다.</dd>
<dt>{{domxref("Document.importNode()")}}</dt>
<dd>외부 문서의 노드 복제본을 반환합니다.</dd>
<dt>{{domxref("Document.normalizeDocument()")}} {{obsolete_inline}}</dt>
<dd>개체 대체, 텍스트 노드 정규화 등의 작업을 실행합니다.</dd>
<dt>{{domxref("Document.releaseCapture()")}} {{non-standard_inline}}</dt>
<dd>문서의 요소에 현재 마우스 캡쳐가 있다면 이를 해제합니다.</dd>
<dt>{{domxref("Document.releaseEvents()")}} {{non-standard_inline}} {{Deprecated_inline}}</dt>
<dd>{{domxref("Window.releaseEvents()")}}를 확인하세요.</dd>
<dt>{{domxref("Document.requestStorageAccess()")}}</dt>
<dd>퍼스트파티<sup>first-party</sup> 저장소로의 접근이 가능한 경우 이행하고 불가능한 경우 거부하는 {{jsxref("Promise")}}를 반환합니다.</dd>
<dt>{{domxref("Document.routeEvent()")}} {{non-standard_inline}} {{obsolete_inline(24)}}</dt>
<dd>{{domxref("Window.routeEvent()")}}를 확인하세요.</dd>
<dt>{{domxref("Document.mozSetImageElement()")}} {{non-standard_inline}}</dt>
<dd>지정한 요소 ID를 위한 배경 이미지로 사용되도록 요소 변경을 허용합니다.</dd>
</dl>
<p><code>Document</code> 인터페이스는 {{domxref("ParentNode")}} 인터페이스를 확장합니다.</p>
<dl>
<dt>{{domxref("document.getElementById()")}}</dt>
<dd>주어진 ID를 가진 요소의 참조를 반환합니다.</dd>
<dt>{{domxref("document.querySelector()")}}</dt>
<dd>문서 내에서 주어진 선택자를 만족하는 첫 번째 {{jsxref("Element")}}를 반환합니다.</dd>
<dt>{{domxref("document.querySelectorAll()")}}</dt>
<dd>주어진 선택자를 만족하는 모든 요소의 {{jsxref("NodeList")}}를 반환합니다.</dd>
</dl>
<p><code>Document</code> 인터페이스는 {{domxref("XPathEvaluator")}} 인터페이스를 확장합니다.</p>
<dl>
<dt>{{domxref("document.createExpression()")}}</dt>
<dd>나중에 (여러 번) 평가할 수 있도록 <code><a href="https://developer.mozilla.org/en-US/docs/XPathExpression" title="XPathExpression">XPathExpression</a></code>을 컴파일합니다.</dd>
<dt>{{domxref("document.createNSResolver()")}}</dt>
<dd>{{domxref("XPathNSResolver")}} 객체를 생성합니다.</dd>
<dt>{{domxref("document.evaluate()")}}</dt>
<dd>XPath 표현을 평가합니다.</dd>
</dl>
<h3 id="HTML_문서의_확장">HTML 문서의 확장</h3>
<p>HTML 문서를 위한 <code>Document</code> 인터페이스는 HTML5 이전엔 {{domxref("HTMLDocument")}} 인터페이스를 상속하고, 이후로는 확장합니다.</p>
<dl>
<dt>{{domxref("document.clear()")}} {{non-standard_inline}} {{Deprecated_inline}}</dt>
<dd>최근의 Firefox와 Internet Explorer를 포함하는 주요 최신 브라우저에서, 이 메소드는 아무것도 하지 않습니다.</dd>
<dt>{{domxref("document.close()")}}</dt>
<dd>작성을 위한 문서 스트림을 닫습니다.</dd>
<dt>{{domxref("document.execCommand()")}}</dt>
<dd>수정 가능한 문서에서 서식 명령을 실행합니다.</dd>
<dt>{{domxref("document.getElementsByName()")}}</dt>
<dd>주어진 이름을 갖는 요소의 목록을 반환합니다.</dd>
<dt>{{domxref("document.hasFocus()")}}</dt>
<dd>포커스가 지정한 문서 내 어느 곳이든 위치한 경우 <code>true</code>를 반환합니다.</dd>
<dt>{{domxref("document.open()")}}</dt>
<dd>작성을 위한 문서 스트림을 엽니다.</dd>
<dt>{{domxref("document.queryCommandEnabled()")}}</dt>
<dd>현재 범위에서 서식 명령을 실행할 수 있다면 <code>true</code>를 반환합니다.</dd>
<dt>{{domxref("document.queryCommandIndeterm()")}}</dt>
<dd>현재 범위에서 서식 명령의 상태를 알 수 없으면 <code>true</code>를 반환합니다.</dd>
<dt>{{domxref("document.queryCommandState()")}}</dt>
<dd>현재 범위에서 서식 명령을 실행했다면 <code>true</code>를 반환합니다.</dd>
<dt>{{domxref("document.queryCommandSupported()")}}</dt>
<dd>현재 범위에서 서식 명령이 지원된다면 <code>true</code>를 반환합니다.</dd>
<dt>{{domxref("document.queryCommandValue()")}}</dt>
<dd>현재 범위에서 서식 명령을 위한 현재 값을 반환합니다.</dd>
<dt>{{domxref("document.write()")}}</dt>
<dd>문서에 텍스트를 작성합니다.</dd>
<dt>{{domxref("document.writeln()")}}</dt>
<dd>문서에 텍스트 한 줄을 작성합니다.</dd>
</dl>
<h3 id="DocumentOrShadowRoot로부터_포함된_메소드">DocumentOrShadowRoot로부터 포함된 메소드</h3>
<p><code>Document</code> 인터페이스는 {{domxref("DocumentOrShadowRoot")}} 믹스인<sup>mixin</sup>이 정의하는 다음의 메서드를 포함합니다. 지금은 Chrome만 구현한 상태라는 점에 유의하세요. 다른 브라우저는 <code>Document</code> 인터페이스에 구현 중입니다.</p>
<dl>
<dt>{{domxref("DocumentOrShadowRoot.getSelection()")}}</dt>
<dd>사용자에의해 선택된 텍스트의 범위 또는 캐럿의 현재 위치를 나타내는 {{domxref('Selection')}} 객체를 반환합니다.</dd>
<dt>{{domxref("DocumentOrShadowRoot.elementFromPoint()")}}</dt>
<dd>지정한 위치에 있는 최상단 엘리먼트를 반환합니다.</dd>
<dt>{{domxref("DocumentOrShadowRoot.elementsFromPoint()")}}</dt>
<dd>지정한 위치에 있는 모든 엘리먼트의 배열을 반환합니다.</dd>
<dt>{{domxref("DocumentOrShadowRoot.caretPositionFromPoint()")}}</dt>
<dd>캐럿을 포함하는 DOM 노드와 그 노드내 캐첫의 문자 오프셋을 포함하는 {{domxref('CaretPosition')}} 객체를 반환합니다.</dd>
</dl>
<h2 id="비표준_확장_non-standard_inline">비표준 확장 {{non-standard_inline}}</h2>
<p>{{non-standard_header}}</p>
<h3 id="Firefox_노트">Firefox 노트</h3>
<p>Mozilla는 XUL 컨텐츠만을 위해 만들어진 비표준 속성의 집합을 정의합니다.</p>
<dl>
<dt>{{domxref("document.currentScript")}} {{non-standard_inline}}</dt>
<dd>현재 실행중인 {{HTMLElement("script")}} 엘리먼트를 반환합니다.</dd>
<dt>{{domxref("document.documentURIObject")}}</dt>
<dd>(<strong>Mozilla 부가 기능 전용!</strong>) 다큐먼트의 URI 를 나타내는 {{Interface("nsIURI")}} 객체를 반환합니다. 이 속성은 권한을 가진 자바스크립트 코드(UniversalXPConnect 권한을 갖는)에서만 특별한 의미를 갖습니다.</dd>
<dt>{{domxref("document.popupNode")}}</dt>
<dd>팝업이 불려진 노드를 반환합니다.</dd>
<dt>{{domxref("document.tooltipNode")}}</dt>
<dd>현재 툴팁의 대상이되는 노드를 반환합니다.</dd>
</dl>
<p>Mozilla 는 또한 일부 비표준 메소드를 정의합니다.</p>
<dl>
<dt>{{domxref("document.execCommandShowHelp")}} {{obsolete_inline("14.0")}}</dt>
<dd>이 메소드는 아무것도 하지 않았지만 항상 예외를 발생시켰으므로 Gecko 14.0 {{geckoRelease("14.0")}} 에서 제거되었습니다.</dd>
<dt>{{domxref("document.getBoxObjectFor")}} {{obsolete_inline}}</dt>
<dd>{{domxref("Element.getBoundingClientRect()")}} 메소드를 대신 사용하세요.</dd>
<dt>{{domxref("document.loadOverlay")}}</dt>
<dd><a href="https://developer.mozilla.org/ko/docs/Mozilla/Tech/XUL" title="XUL_Overlays">XUL 오버레이</a>를 동적으로 로드합니다. XUL 다큐먼트에서만 동작합니다.</dd>
<dt>{{domxref("document.queryCommandText")}} {{obsolete_inline("14.0")}}</dt>
<dd>이 메소드는 아무것도 하지 않았지만 예외를 발생시켰으므로 Gecko 14.0 {{geckoRelease("14.0")}} 에서 제거되었습니다.</dd>
</dl>
<h3 id="Internet_Explorer_노트">Internet Explorer 노트</h3>
<p>Microsoft는 일부 비표준 속성을 정의합니다.</p>
<dl>
<dt>{{domxref("document.fileSize")}}* {{non-standard_inline}} {{obsolete_inline}}</dt>
<dd>Returns size in bytes of the document. Starting with Internet Explorer 11, that property is no longer supported. See <a href="http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx" title="http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx">MSDN</a>.</dd>
</dl>
<p>Internet Explorer는 <code>Document</code> 인터페이스내 <code>Node</code> 인터페이스의 모든 메소드를 지원하지 않습니다:</p>
<dl>
<dt>{{domxref("document.contains")}}</dt>
<dd>대안으로 <code>document.body.contains()</code> 를 사용할 수 있습니다.</dd>
</dl>
<h2 id="명세">명세</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">명세</th>
<th scope="col">상태</th>
<th scope="col">코멘트</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName("DOM WHATWG", "#interface-document", "Document")}}</td>
<td>{{Spec2("DOM WHATWG")}}</td>
<td>DOM 3 대체 의도</td>
</tr>
<tr>
<td>{{SpecName("HTML WHATWG", "dom.html#the-document-object", "Document")}}</td>
<td>{{Spec2("HTML WHATWG")}}</td>
<td>{{domxref("HTMLDocument")}} 인터페이스를 <code>Document</code> 확장으로 전환.</td>
</tr>
<tr>
<td>{{SpecName("HTML Editing", "#dom-document-getselection", "Document")}}</td>
<td>{{Spec2("HTML Editing")}}</td>
<td><code>Document</code> 인터페이스 확장</td>
</tr>
<tr>
<td>{{SpecName("CSSOM View", "#extensions-to-the-document-interface", "Document")}}</td>
<td>{{Spec2("CSSOM View")}}</td>
<td><code>Document</code> 인터페이스 확장</td>
</tr>
<tr>
<td>{{SpecName("CSSOM", "#extensions-to-the-document-interface", "Document")}}</td>
<td>{{Spec2("CSSOM")}}</td>
<td><code>Document</code> 인터페이스 확장</td>
</tr>
<tr>
<td>{{SpecName("Pointer Lock", "#extensions-to-the-document-interface", "Document")}}</td>
<td>{{Spec2("Pointer Lock")}}</td>
<td><code>Document</code> 인터페이스 확장</td>
</tr>
<tr>
<td>{{SpecName("Page Visibility API", "#extensions-to-the-document-interface", "Document")}}</td>
<td>{{Spec2("Page Visibility API")}}</td>
<td><code>visibilityState</code> 와 <code>hidden</code> 속성과 <code>onvisibilitychange</code> 이벤트 리스너를 갖도록 <code>Document</code> 인터페이스 확장.</td>
</tr>
<tr>
<td>{{SpecName("Selection API", "#extensions-to-document-interface", "Document")}}</td>
<td>{{Spec2("Selection API")}}</td>
<td><code>getSelection()</code>, <code>onselectstart</code> 와 <code>onselectionchange</code> 추가.</td>
</tr>
<tr>
<td>{{SpecName("DOM4", "#interface-document", "Document")}}</td>
<td>{{Spec2("DOM4")}}</td>
<td>DOM 3 대체</td>
</tr>
<tr>
<td>{{SpecName("DOM3 Core", "#i-Document", "Document")}}</td>
<td>{{Spec2("DOM3 Core")}}</td>
<td>DOM 2 대체</td>
</tr>
<tr>
<td>{{SpecName("DOM3 XPath", "xpath.html#XPathEvaluator", "XPathEvaluator")}}</td>
<td>{{Spec2("DOM3 XPath")}}</td>
<td>다큐먼트를 확장하는 {{domxref("XPathEvaluator")}} 인터페이스 정의.</td>
</tr>
<tr>
<td>{{SpecName("DOM2 Core", "#i-Document", "Document")}}</td>
<td>{{Spec2("DOM2 Core")}}</td>
<td>DOM 1 대체</td>
</tr>
<tr>
<td>{{SpecName("DOM1", "#i-Document", "Document")}}</td>
<td>{{Spec2("DOM1")}}</td>
<td>인터페이스 초기 정의</td>
</tr>
</tbody>
</table>
<h2 id="브라우저_호환성">브라우저 호환성</h2>
<p>{{Compat("api.Document")}}</p>
|