aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/document/index.md
blob: 4cefe81a7d842b73f092346ca617ba014397a6ad (plain)
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
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
---
title: Document
slug: Web/API/Document
tags:
  - API
  - DOM
  - Document
  - インターフェイス
  - リファレンス
browser-compat: api.Document
translation_of: Web/API/Document
---
{{APIRef("DOM")}}

**`Document`** インターフェイスはブラウザーに読み込まれたウェブページを表し、 [DOM ツリー](/ja/docs/Web/API/Document_Object_Model/Using_the_W3C_DOM_Level_1_Core)であるウェブページのコンテンツへのエントリーポイントとして働きます。

DOM ツリーには {{HTMLElement("body")}} や {{HTMLElement("table")}} など、[多数の要素](/ja/docs/Web/HTML/Element)があります。これはページの URL を取得したり文書で新たな要素を作成するなど、文書全体に関わる機能を提供します。

{{InheritanceDiagram}}

`Document` インターフェイスは、あらゆる種類の文書に対して共通のプロパティやメソッドを提供します。また、文書の種類 (例: [HTML](/ja/docs/Web/HTML)、[XML](/ja/docs/Web/XML)、SVG など) に応じて、より大規模な API を使用できます。コンテンツタイプ `"text/html"` で提供される HTML 文書では、 {{DOMxRef("HTMLDocument")}} インターフェイスも実装します。一方 XML や SVG 文書では、 {{DOMxRef("XMLDocument")}} インターフェイスを実装します。

## コンストラクター

- {{DOMxRef("Document.Document", "Document()")}}
  - : 新しい `Document` オブジェクトを作成します。

## プロパティ

_このインターフェイスは、 {{DOMxRef("Node")}} インターフェイスおよび {{DOMxRef("EventTarget")}} インターフェイスのプロパティも継承しています。_

- {{DOMxRef("Document.activeElement")}} {{ReadOnlyInline}}
  - : 現在フォーカスのある {{DOMxRef('Element')}} を返します。
- {{DOMxRef("Document.body")}}
  - : 現在の文書の {{HTMLElement("body")}} または {{htmlelement("frameset")}} ノードを返します。
- {{DOMxRef("Document.characterSet")}}{{ReadOnlyInline}}
  - : 文書に適用されている文字セットを返します。
- {{domxref("Document.childElementCount")}} {{readonlyInline}}
  - : 現在の文書の子要素の数を返します。
- {{domxref("Document.children")}} {{readonlyInline}}
  - : 現在の文書の子要素を返します。
- {{DOMxRef("Document.compatMode")}} {{Experimental_Inline}}{{ReadOnlyInline}}
  - : 文書が _Quirks_ モードと _Strict_ モードのどちらで描画されているかを示します。
- {{DOMxRef("Document.contentType")}} {{Experimental_Inline}}{{ReadOnlyInline}}
  - : 現在の文書の MIME ヘッダーから Content-Type を返します。
- {{DOMxRef("Document.currentScript")}}{{ReadOnlyInline}}
  - : {{HTMLElement("script")}} 要素のうち、現在処理中で、かつ [JavaScript モジュールでないもの](https://github.com/whatwg/html/issues/997)を返します。
- {{DOMxRef("Document.doctype")}}{{ReadOnlyInline}}
  - : 現在の文書の文書型宣言 (DTD) を返します。
- {{DOMxRef("Document.documentElement")}}{{ReadOnlyInline}}
  - : 文書の直接の子である {{DOMxRef("Element")}} を返します。 HTML 文書では、これは通常は {{DOMxRef("HTMLHtmlElement")}} オブジェクトで、文書の {{HTMLElement("html")}} 要素を表します。
- {{DOMxRef("Document.documentURI")}}{{ReadOnlyInline}}
  - : 文書の場所を文字列で返します。
- {{DOMxRef("Document.embeds")}}{{ReadOnlyInline}}
  - : {{DOMxRef("HTMLCollection")}} で、現在の文書に含まれる埋め込まれた {{HTMLElement('embed')}} 要素のリストを返します。
- {{domxref("Document.firstElementChild")}} {{readonlyInline}}
  - : 現在の文書における最初の子要素を返します。
- {{DOMxRef("Document.fonts")}}
  - : 現在の文書の {{DOMxRef("FontFaceSet")}} インターフェイスを返します。
- {{DOMxRef("Document.forms")}}{{ReadOnlyInline}}
  - : {{DOMxRef("HTMLCollection")}} で現在の文書の {{HTMLElement("form")}} 要素を返します。
- {{DOMxRef("Document.fullscreenElement")}} {{ReadOnlyInline}}
  - : この文書で現在全画面モードになっている要素です。
- {{DOMxRef("Document.head")}}{{ReadOnlyInline}}
  - : 現在の文書の {{HTMLElement("head")}} 要素を返します。
- {{DOMxRef("Document.hidden")}}{{ReadOnlyInline}}
  - : このページが非表示と見なされているかどうかを論理値で返します。
- {{DOMxRef("Document.images")}}{{ReadOnlyInline}}
  - : {{DOMxRef("HTMLCollection")}} で、現在の文書の画像のリストを返します。
- {{DOMxRef("Document.implementation")}}{{ReadOnlyInline}}
  - : 現在の文書に関連付けられた DOM 実装を返します。
- {{domxref("Document.lastElementChild")}} {{readonlyInline}}
  - : 現在の文書における最後の子要素を返します。
- {{DOMxRef("Document.links")}}{{ReadOnlyInline}}
  - : {{DOMxRef("HTMLCollection")}} で、文書内のすべてのハイパーリンクのリストを返します。
- {{DOMxRef("Document.mozSyntheticDocument")}} {{Non-standard_Inline}}
  - : 単独の画像、動画、音声ファイルなど、文書が合成されたものである限り `true` を返します。
- {{DOMxRef("Document.pictureInPictureElement")}} {{ReadOnlyInline}}
  - : この文書で現在、ピクチャインピクチャモードで表示されている要素 ({{DOMxRef('Element')}}) を返します。
- {{DOMxRef("Document.pictureInPictureEnabled")}} {{ReadOnlyInline}}
  - : ピクチャインピクチャ機能が有効であれば true を返します。
- {{DOMxRef("Document.plugins")}}{{ReadOnlyInline}}
  - : {{DOMxRef("HTMLCollection")}} で、利用可能なプラグインのリストを返します。
- {{DOMxRef("Document.pointerLockElement")}} {{ReadOnlyInline}}
  - : ポインターがロックされている場合、マウスイベントのターゲットとして設定された要素を返します。ロック町の場合、ポインターがロックされていない場合、ターゲットが他の文書にある場合は `null` を返します。
- {{DOMxRef("Document.featurePolicy")}} {{Experimental_Inline}}{{ReadOnlyInline}}
  - : 特定の文書に適用される機能ポリシーを簡単に導入するための API を提供する {{DOMxRef("FeaturePolicy")}} インターフェイスを返します。
- {{DOMxRef("Document.scripts")}}{{ReadOnlyInline}}
  - : {{DOMxRef("HTMLCollection")}} で、文書内のすべての {{HTMLElement("script")}} 要素を返します。
- {{DOMxRef("Document.scrollingElement")}}{{ReadOnlyInline}}
  - : 文書をスクロールする {{DOMxRef("Element")}} への参照を返します。
- {{DOMxRef("Document.styleSheets")}} {{ReadOnlyInline}}
  - : {{DOMxRef('StyleSheetList')}} で、文書で明示的にリンクされているスタイルシートや、文書に埋め込まれているスタイルシート({{DOMxRef('CSSStyleSheet')}} オブジェクトのリスト)を返します。
- {{DOMxRef("Document.timeline")}} {{Experimental_Inline}}{{ReadOnlyInline}}
  - : タイムラインを {{domxref("DocumentTimeline")}} の特別なインスタンスで返します。これはページの読み込み時に自動的に生成されます。
- {{DOMxRef("Document.visibilityState")}}{{ReadOnlyInline}}
  - : 文書の可視性を表す `string` を返します。 `visible`, `hidden`, `prerender`, `unloaded` のいずれかの値になります。

### HTML 文書向けの拡張

_HTML 文書用の `Document` インターフェイスは {{DOMxRef("HTMLDocument")}} インターフェイスから継承されていたり、HTML5 文書向けに拡張されていたりします。_

- {{DOMxRef("Document.cookie")}}
  - : 文書のクッキーをセミコロンで区切られたリストで返すか、単一のクッキーを設定するかします。
- {{DOMxRef("Document.defaultView")}}{{ReadOnlyInline}}
  - : window オブジェクトへの参照を返します。
- {{DOMxRef("Document.designMode")}}
  - : 文書全体を編集可能かを取得/設定します。
- {{DOMxRef("Document.dir")}}
  - : 文書の書字方向 (rtl/ltr) を取得/設定します。
- {{DOMxRef("Document.domain")}} {{Deprecated_Inline}}
  - : 現在の文書のドメインを取得/設定します。
- {{DOMxRef("Document.lastModified")}}{{ReadOnlyInline}}
  - : 文書の最終更新日を返します。
- {{DOMxRef("Document.location")}}{{ReadOnlyInline}}
  - : 現在の文書の URI を返します。
- {{DOMxRef("Document.readyState")}}{{ReadOnlyInline}}
  - : 文書の読み込み状況を表す文字列を返します。
- {{DOMxRef("Document.referrer")}}{{ReadOnlyInline}}
  - : このページへリンクしたページの URI を返します。
- {{DOMxRef("Document.title")}}
  - : 現在の文書のタイトルを設定または取得します。
- {{DOMxRef("Document.URL")}}{{ReadOnlyInline}}
  - : 現在の文書の URL を含む文字列を返します。

### イベントハンドラー

_`Document` インターフェイスは [GlobalEventHandlers](/ja/docs/Web/API/GlobalEventHandlers#event_handlers) で定義されているその他のイベントハンドラーで拡張されています。_

- {{DOMxRef("Document.onafterscriptexecute")}} {{Non-standard_Inline}}
  - : {{domxref("Document/afterscriptexecute_event", "afterscriptexecute")}} イベント用のイベントハンドラーを表します。
- {{DOMxRef("Document.onbeforescriptexecute")}} {{Non-standard_Inline}}
  - : {{domxref("Document/beforescriptexecute_event", "beforescriptexecute")}} イベント用のイベントハンドラーを表します。
- {{DOMxRef("Document.oncopy")}} {{Non-standard_Inline}}
  - : {{domxref("Document/copy_event", "copy")}} イベント用のイベントハンドラーを表します。
- {{DOMxRef("Document.oncut")}} {{Non-standard_Inline}}
  - : {{domxref("Document/cut_event", "cut")}} イベント用のイベントハンドラーを表します。
- {{DOMxRef("Document.onfullscreenchange")}}
  - : [イベントハンドラー](/ja/docs/Web/Events/Event_handlers)で、  {{domxref("Document/fullscreenchange_event", "fullscreenchange")}} イベントが発行されたときに呼び出されるコードを表します。
- {{DOMxRef("Document.onfullscreenerror")}}
  - : [イベントハンドラー](/ja/docs/Web/Events/Event_handlers)で、  {{domxref("Document/fullscreenerror_event", "fullscreenerror")}} イベントが発行されたときに呼び出されるコードを表します。
- {{DOMxRef("Document.onpaste")}} {{Non-standard_Inline}}
  - : {{domxref("Document/paste_event", "paste")}} イベント用のイベントハンドラーを表します。
- {{DOMxRef("Document.onreadystatechange")}}
  - : {{domxref("Document/readystatechange_event", "readystatechange")}} イベント用のイベントハンドラーを表します。
- {{DOMxRef("GlobalEventHandlers.onselectionchange")}} {{Experimental_Inline}}
  - : [イベントハンドラー](/ja/docs/Web/Events/Event_handlers)で、  {{domxref("Document/selectionchange_event", "selectionchange")}} イベントが発行されたときに呼び出されるコードを表します。
- {{DOMxRef("Document.onvisibilitychange")}}
  - : [イベントハンドラー](/ja/docs/Web/Events/Event_handlers)で、  {{domxref("Document/visibilitychange_event", "visibilitychange")}} イベントが発行されたときに呼び出されるコードを表します。

### 非推奨のプロパティ

- {{DOMxRef("Document.alinkColor")}} {{Deprecated_Inline}}
  - : 文書本文内のアクティブなリンクの色を取得または設定します。
- {{DOMxRef("Document.all")}} {{Deprecated_Inline}} {{Non-standard_Inline}}
  - : 文書内のすべての要素にアクセスできます。文書ノードを起点とする {{DOMxRef('HTMLAllCollection')}} を返します。これは古い標準外のプロパティですので、使用しないようにしてください。
- {{DOMxRef("Document.anchors")}} {{Deprecated_Inline}}{{ReadOnlyInline}}
  - : 文書内のすべてのアンカーのリストを返します。
- {{DOMxRef("Document.applets")}} {{Deprecated_Inline}}{{ReadOnlyInline}}
  - : 文書内にあるアプレットのリスト (出現順) を返します。
- {{DOMxRef("Document.bgColor")}} {{Deprecated_Inline}}
  - : 現在の文書の背景色を取得または設定します。
- {{DOMxRef("Document.characterSet","Document.charset")}} {{Deprecated_Inline}}{{ReadOnlyInline}}
  - : {{DOMxRef("Document.characterSet")}} の別名です。代わりに {{DOMxRef("Document.characterSet")}} を使用してください。
- {{DOMxRef("Document.fgColor")}} {{Deprecated_Inline}}
  - : 現在の文書の前景色または文字色を取得/設定します。
- {{DOMxRef("Document.fullscreen")}} {{deprecated_inline}}
  - : 文書が{{DOMxRef("Using_full-screen_mode","全画面モード", "", 1)}}であるときに、`true` になります。
- {{DOMxRef("Document.height")}} {{Non-standard_Inline}} {{deprecated_inline}}
  - : 現在の文書の高さを取得/設定します。
- {{DOMxRef("Document.characterSet", "Document.inputEncoding")}} {{Deprecated_Inline}}{{ReadOnlyInline}}
  - : {{DOMxRef("Document.characterSet")}} の別名です。代わりにそちらを使用してください。
- {{DOMxRef("Document.lastStyleSheetSet")}} {{deprecated_inline}}{{ReadOnlyInline}}
  - : 直前に有効であったスタイルシートセットの名称を返します。 {{DOMxRef("Document.selectedStyleSheetSet","selectedStyleSheetSet")}} に値を設定してスタイルシートを変更するまで、この値は `null` になります。
- {{DOMxRef("Document.linkColor")}} {{Deprecated_Inline}}
  - : document 内のハイパーリンクの色を取得/設定します。
- {{DOMxRef("Document.preferredStyleSheetSet")}} {{deprecated_inline}}{{ReadOnlyInline}}
  - : ページの作者によって設定された、優先的なスタイルシートを返します。
- {{DOMxRef("Document.rootElement")}} {{Deprecated_Inline}}
  - : {{DOMxRef("Document.documentElement")}} と同様ですが、 {{SVGElement("svg")}} ルート要素専用です。こちらのプロパティを代わりに使用してください。
- {{DOMxRef("Document.selectedStyleSheetSet")}} {{deprecated_inline}}
  - : 現在どのスタイルシートセットを使用しているかを返します。
- {{DOMxRef("Document.styleSheetSets")}} {{deprecated_inline}}{{ReadOnlyInline}}
  - : 文書で使用できるスタイルシートセットのリストを返します。
- {{DOMxRef("Document.vlinkColor")}} {{Deprecated_Inline}}
  - : 訪問済みのハイパーリンクの色を取得/設定します。
- {{DOMxRef("Document.width")}} {{Non-standard_Inline}} {{deprecated_inline}}
  - : 現在の文書の幅を返します。
- {{DOMxRef("Document.xmlEncoding")}} {{Deprecated_Inline}}
  - : XML 宣言によって決められたエンコーディングを返します。
- {{DOMxRef("Document.xmlStandalone")}} {{deprecated_inline}}
  - : XML 宣言で文書がスタンドアロンである (_例_: DTD の外部パートが文書のコンテンツに影響する) 場合に `true` を、そうでない場合に `false` を返します。
- {{DOMxRef("Document.xmlVersion")}} {{deprecated_inline}}
  - : XML 宣言で指定されたバージョン番号、または宣言が省略されている場合に `"1.0"` を返します。

## メソッド

_このインターフェイスは、{{DOMxRef("Node")}} インターフェイスおよび {{DOMxRef("EventTarget")}} インターフェイスのメソッドを継承します。_

- {{DOMxRef("Document.adoptNode()")}}
  - : 外部文書からノードを取り込みます。
- {{DOMxRef("Document.append()")}}
  - : 文書の最後の子の後に {{domxref("Node")}} オブジェクトまたは {{domxref("DOMString")}} オブジェクトの集合を挿入します。
- {{DOMxRef("Document.captureEvents()")}} {{Deprecated_Inline}}
  - : {{DOMxRef("Window.captureEvents")}} をご覧ください。
- {{DOMxRef("Document.caretPositionFromPoint()")}}
  - : キャレットを含む DOM ノードと、そのノード内でのキャレットの文字オフセットを含む {{DOMxRef('CaretPosition')}} オブジェクトを返します。
- {{DOMxRef("Document.caretRangeFromPoint()")}} {{Non-standard_Inline}}
  - : 指定した座標にある文書の断片の {{DOMxRef("Range")}} オブジェクトを取得します。
- {{DOMxRef("Document.createAttribute()")}}
  - : 新しい {{DOMxRef("Attr")}} オブジェクトを生成して、返します。
- {{DOMxRef("Document.createAttributeNS()")}}
  - : 指定した名前空間に新しい属性ノードを生成して、返します。
- {{DOMxRef("Document.createCDATASection()")}}
  - : 新しい CDATA ノードを生成して、返します。
- {{DOMxRef("Document.createComment()")}}
  - : 新しいコメントノードを生成して、返します。
- {{DOMxRef("Document.createDocumentFragment()")}}
  - : 新しい文書断片を生成します。
- {{DOMxRef("Document.createElement()")}}
  - : 指定したタグ名で新しい要素を生成します。
- {{DOMxRef("Document.createElementNS()")}}
  - : 指定したタグ名およびネームスペース URI で、新しい要素を生成します。
- {{DOMxRef("Document.createEntityReference()")}} {{deprecated_inline}}
  - : 新しい Entity Reference オブジェクトを生成して、返します。
- {{DOMxRef("Document.createEvent()")}}
  - : Event オブジェクトを生成します。
- {{DOMxRef("Document.createNodeIterator()")}}
  - : {{DOMxRef("NodeIterator")}} オブジェクトを生成します。
- {{DOMxRef("Document.createProcessingInstruction()")}}
  - : 新しい {{DOMxRef("ProcessingInstruction")}} オブジェクトを生成します。
- {{DOMxRef("Document.createRange()")}}
  - : {{DOMxRef("Range")}} オブジェクトを生成します。
- {{DOMxRef("Document.createTextNode()")}}
  - : テキストノードを生成します。
- {{DOMxRef("Document.createTouch()")}} {{Deprecated_Inline}}
  - : {{DOMxRef("Touch")}} オブジェクトを生成します。
- {{DOMxRef("Document.createTouchList()")}} {{Deprecated_Inline}}
  - : {{DOMxRef("TouchList")}} オブジェクトを生成します。
- {{DOMxRef("Document.createTreeWalker()")}}
  - : {{DOMxRef("TreeWalker")}} オブジェクトを生成します。
- {{DOMxRef("Document.elementFromPoint()")}}
  - : 指定された座標の最上位の要素を返します。
- {{DOMxRef("Document.elementsFromPoint()")}}
  - : 指定された座標にあるすべての要素の配列を返します。
- {{DOMxRef("Document.enableStyleSheetsForSet()")}} {{deprecated_inline}}
  - : 指定したスタイルシートセットのスタイルシートを有効化します。
- {{DOMxRef("Document.exitPictureInPicture()")}}
  - : 浮動ピクチャーインピクチャーウィンドウから動画を取り出し、元のコンテナーに戻します。
- {{DOMxRef("Document.exitPointerLock()")}} {{Experimental_Inline}}
  - : ポインターロックを解放します。
- {{DOMxRef("Document.getAnimations()")}}
  - : 現在実行中であるすべての {{DOMxRef("Animation")}} オブジェクトの配列を返します。この対象要素は、`document` の子孫要素です。
- {{domxref("Document.getBoxQuads()")}} {{experimental_inline}}
  - : このノードの CSS フラグメントを表す {{domxref("DOMQuad")}} オブジェクトのリストを返します。
- {{DOMxRef("Document.getElementById", "Document.getElementById()")}}
  - : 識別された要素のオブジェクト参照を返します。
- {{DOMxRef("Document.getElementsByClassName()")}}
  - : 指定されたクラス名を持つ要素のリストを返します。
- {{DOMxRef("Document.getElementsByTagName()")}}
  - : 指定されたタグ名を持つ要素のリストを返します。
- {{DOMxRef("Document.getElementsByTagNameNS()")}}
  - : 指定されたタグ名と名前空間を持つ要素のリストを返します。
- {{DOMxRef("Document.getSelection()")}}
  - : ユーザーが現在選択しているテキスト範囲、または現在のキャレットの位置を表す {{DOMxRef('Selection')}} オブジェクトを返します。
- {{DOMxRef("Document.hasStorageAccess()")}} {{Experimental_Inline}}
  - : 文書が自分自身 (first-party) のストレージにアクセスしたかどうかを示す論理値で解決する {{jsxref("Promise")}} を返します。
- {{DOMxRef("Document.importNode()")}}
  - : 外部文書のノードの複製を返します。
- {{DOMxRef("Document.normalizeDocument()")}} {{deprecated_inline}}
  - : エンティティの置換や、テキストノードの正規化などを行います。
- {{DOMxRef("Document.prepend()")}}
  - : 文書の最初の子の前に、 {{domxref("Node")}} オブジェクトまたは {{domxref("DOMString")}} オブジェクトを挿入します。
- {{DOMxRef("Document.querySelector()")}}
  - : 指定したセレクターに一致する、文書内で最初の要素ノードを返します。
- {{DOMxRef("Document.querySelectorAll()")}}
  - : 指定したセレクターに一致する、文書内のすべての要素ノードのリストを返します。
- {{DOMxRef("Document.releaseCapture()")}} {{Non-standard_Inline}}
  - : この文書内の要素でマウスキャプチャを行っている場合、マウスキャプチャを解放します。
- {{DOMxRef("Document.releaseEvents()")}} {{Non-standard_Inline}} {{Deprecated_Inline}}
  - : {{DOMxRef("Window.releaseEvents()")}} をご覧ください。
- {{DOMxRef("Document.replaceChildren()")}}
  - : 文書の既存の子を、指定された新しい子の集合で置き換えます。
- {{DOMxRef("Document.requestStorageAccess()")}}
  - : 自分自身 (first-party) のストレージへのアクセスが許可された場合は解決し、拒否された場合は拒否される {{jsxref("Promise")}} を返します。
- {{DOMxRef("Document.mozSetImageElement()")}} {{Non-standard_Inline}}
  - : 指定した ID を持つ要素の背景画像として使用する要素を変更できます。

`Document` インターフェイスは、{{DOMxRef("XPathEvaluator")}} インターフェイスによって拡張されています。

- {{DOMxRef("Document.createExpression()")}}
  - : (繰り返し) 評価に使用できる [`XPathExpression`](/ja/docs/XPathExpression) をコンパイルします。
- {{DOMxRef("Document.createNSResolver()")}}
  - : {{DOMxRef("XPathNSResolver")}} オブジェクトを生成します。
- {{DOMxRef("Document.evaluate()")}}
  - : XPath 表現を評価します。

### HTML 文書向けの拡張

HTML 文書用の `Document` インターフェイスは {{DOMxRef("HTMLDocument")}} インターフェイスから継承する、あるいは HTML5 文書向けに拡張されています。

- {{DOMxRef("Document.clear()")}} {{Non-standard_Inline}} {{Deprecated_Inline}}
  - : 最近の Firefox や Internet Explorer を含む大部分の現行ブラウザーは、何も行いません。
- {{DOMxRef("Document.close()")}}
  - : 書き込み用の文書ストリームを閉じます。
- {{DOMxRef("Document.execCommand()")}} {{deprecated_inline}}
  - : 編集可能な文書で、フォーマットコマンドを実行します。
- {{DOMxRef("Document.getElementsByName()")}}
  - : (引数で) 与えられた名前 (name) を持つ要素のリストを返します。
- {{DOMxRef("Document.hasFocus()")}}
  - : 指定した文書内にフォーカスがある場合に、 `true` を返します。
- {{DOMxRef("Document.open()")}}
  - : 書き込み用の文書ストリームを開きます。
- {{DOMxRef("Document.queryCommandEnabled()")}} {{deprecated_inline}}
  - : 現在の領域でフォーマットコマンドを実行できる場合に、 true を返します。
- {{DOMxRef("Document.queryCommandIndeterm()")}} {{deprecated_inline}}
  - : 現在の領域でフォーマットコマンドの状態が不確定である場合に true を返します。
- {{DOMxRef("Document.queryCommandState()")}} {{deprecated_inline}}
  - : 現在の領域でフォーマットコマンドを実行した場合に true を返します。
- {{DOMxRef("Document.queryCommandSupported()")}} {{deprecated_inline}}
  - : 現在の領域でフォーマットコマンドをサポートしている場合に、true を返します。
- {{DOMxRef("Document.queryCommandValue()")}} {{deprecated_inline}}
  - : 指定したフォーマットコマンドについて、現在の領域における値を返します。
- {{DOMxRef("Document.write()")}}
  - : 文書にテキストを書き込みます。
- {{DOMxRef("Document.writeln()")}}
  - : 文書にテキスト行を書き込みます。

## イベント

これらのイベントを待ち受けするには、 `addEventListener()` を使用するか、本インターフェイスの `onイベント名` プロパティへイベントリスナーを代入するかしてください。

- {{DOMxRef("Document/scroll_event", "scroll")}}
  - : 文書のビューまたは要素がスクロールしたときに発行されます。
    {{DOMxRef("GlobalEventHandlers.onscroll", "onscroll")}} プロパティからも利用できます。
- {{DOMxRef("Document/visibilitychange_event", "visibilitychange")}}
  - : タブの内容の表示・非表示の状態が切り替わった時に発行されます。
    {{DOMxRef("Document.onvisibilitychange", "onvisibilitychange")}} プロパティからも利用できます。
- {{DOMxRef("Document/wheel_event","wheel")}}
  - : ユーザーがポインティングデバイス (通常はマウス) のホイールボタンを回転した時に発行されます。
    {{DOMxRef("GlobalEventHandlers.onwheel", "onwheel")}} プロパティからも利用できます。

### アニメーションイベント

- {{DOMxRef("Document/animationcancel_event", "animationcancel")}}
  - : アニメーションが予期せず中断された時に発行されます。
    {{DOMxRef("GlobalEventHandlers/onanimationcancel", "onanimationcancel")}} プロパティからも利用できます。
- {{DOMxRef("Document/animationend_event", "animationend")}}
  - : アニメーションが正常に完了したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onanimationend", "onanimationend")}} プロパティからも利用できます。
- {{DOMxRef("Document/animationiteration_event", "animationiteration")}}
  - : アニメーションの1周期が完了したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onanimationiteration", "onanimationiteration")}} プロパティからも利用できます。
- {{DOMxRef("Document/animationstart_event", "animationstart")}}
  - : アニメーションが始まった時に発行されます。
    {{DOMxRef("GlobalEventHandlers/onanimationstart", "onanimationstart")}} プロパティからも利用できます。

### クリップボードイベント

- {{DOMxRef("Document/copy_event", "copy")}}
  - : ユーザーがブラウザーのユーザーインターフェイスからコピー操作を開始した時に発行されます。
    {{DOMxRef("HTMLElement/oncopy", "oncopy")}} プロパティからも利用できます。
- {{DOMxRef("Document/cut_event", "cut")}}
  - : ユーザーがブラウザーのユーザーインターフェイスから切り取り操作を開始したときに発行されます。
    {{DOMxRef("HTMLElement/oncut", "oncut")}} プロパティからも利用できます。
- {{DOMxRef("Document/paste_event", "paste")}}
  - : ユーザーがブラウザーのユーザーインターフェイスから貼り付け操作を開始したときに発行されます。
    {{DOMxRef("HTMLElement/onpaste", "onpaste")}} プロパティからも利用できます。

### ドラッグ&ドロップイベント

- {{DOMxRef("Document/drag_event", "drag")}}
  - : 要素またはテキストの選択範囲をユーザーがドラッグしている間、数百ミリ秒ごとに発行されます。
    {{DOMxRef("GlobalEventHandlers/ondrag", "ondrag")}} プロパティからも利用できます。
- {{DOMxRef("Document/dragend_event", "dragend")}}
  - : ドラッグ操作が終了したとき (マウスボタンを離したときやエスケープキーを押したとき) に発行されます。
    {{DOMxRef("GlobalEventHandlers/ondragend", "ondragend")}} プロパティからも利用できます。
- {{DOMxRef("Document/dragenter_event", "dragenter")}}
  - : ドラッグ中の要素またはテキストの選択範囲が妥当なドロップ対象に入ったときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ondragenter", "ondragenter")}} プロパティからも利用できます。
- {{DOMxRef("Document/dragleave_event", "dragleave")}}
  - : ドラッグ中の要素またはテキストの選択範囲が妥当なドロップ対象から外れたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ondragleave", "ondragleave")}} プロパティからも利用できます。
- {{DOMxRef("Document/dragover_event", "dragover")}}
  - : 要素またはテキストの選択範囲が妥当なドロップ対象の上をドラッグされているときに (数ミリ秒ごとに) 発行されます。
    {{DOMxRef("GlobalEventHandlers/ondragover", "ondragover")}} プロパティからも利用できます。
- {{DOMxRef("Document/dragstart_event", "dragstart")}}
  - : ユーザーが要素またはテキストの選択範囲のドラッグを開始したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ondragstart", "ondragstart")}} プロパティからも利用できます。
- {{DOMxRef("Document/drop_event", "drop")}}
  - : 要素またはテキストの選択範囲が妥当なドロップ対象にドロップされたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ondrop", "ondrop")}} プロパティからも利用できます。

### 全画面イベント

- {{DOMxRef("Document/fullscreenchange_event", "fullscreenchange")}}
  - : `Document` が[全画面](/ja/docs/Web/API/Fullscreen_API/Guide)モードへ移行したとき、または解除されたときに発行されます。
    {{DOMxRef("Document.onfullscreenchange", "onfullscreenchange")}} プロパティからも利用できます。
- {{DOMxRef("Document/fullscreenerror_event", "fullscreenerror")}}
  - : [全画面](/ja/docs/Web/API/Fullscreen_API/Guide)モードへ切り替えようとしたとき、または解除しようとしたときにエラーが発生した場合に発行されます。
    {{DOMxRef("Document.onfullscreenerror", "onfullscreenerror")}} プロパティからも利用できます。

### キーボードイベント

- {{DOMxRef("Document/keydown_event", "keydown")}}
  - : キーが押されたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onkeydown", "onkeydown")}} プロパティからも利用できます。
- {{DOMxRef("Document/keypress_event", "keypress")}}
  - : 文字値を生成するキーが押下されたときに発行されます。 {{Deprecated_Inline}}
    {{DOMxRef("GlobalEventHandlers/onkeypress", "onkeypress")}} プロパティからも利用できます。
- {{DOMxRef("Document/keyup_event", "keyup")}}
  - : キーを離したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onkeyup", "onkeyup")}} プロパティからも利用できます。

### ロード&アンロードイベント

- {{DOMxRef("Document/DOMContentLoaded_event", "DOMContentLoaded")}}
  - : 文書が完全に読み込まれて解釈されたときに、スタイルシート、画像、サブフレームの読み込みが完了するのを待たずに発行されます。
- {{DOMxRef("Document/readystatechange_event", "readystatechange")}}
  - : 文書の {{DOMxRef("Document/readyState", "readyState")}} 属性が変更されたときに発行されます。
    `onreadystatechange` プロパティからも利用できます。

### ポインターイベント

- {{DOMxRef("Document/gotpointercapture_event", "gotpointercapture")}}
  - : {{domxref("Element/setPointerCapture", "setPointerCapture()")}} を使用して要素がポインターをキャプチャしたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ongotpointercapture", "ongotpointercapture")}} プロパティからも利用できます。
- {{DOMxRef("Document/lostpointercapture_event", "lostpointercapture")}}
  - : [キャプチャされたポインター](/ja/docs/Web/API/Pointer_events#pointer_capture)が解放されたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onlostpointercapture", "onlostpointercapture")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointercancel_event", "pointercancel")}}
  - : ポインターイベントがキャンセルされたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointercancel", "onpointercancel")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointerdown_event", "pointerdown")}}
  - : ポインターがアクティブになったときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointerdown", "onpointerdown")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointerenter_event", "pointerenter")}}
  - : ポインターが要素やその子孫のヒットテスト境界の中へ移動したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointerenter", "onpointerenter")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointerleave_event", "pointerleave")}}
  - : ポインターが要素のヒットテスト境界の外へ移動したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointerleave", "onpointerleave")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointerlockchange_event", "pointerlockchange")}}
  - : ポインターがロックまたはアンロックされたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointerlockchange", "onpointerlockchange")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointerlockerror_event", "pointerlockerror")}}
  - : ポインターをロックしようとして失敗したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointerlockerror", "onpointerlockerror")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointermove_event", "pointermove")}}
  - : ポインターの座標が変化したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointermove", "onpointermove")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointerout_event", "pointerout")}}
  - : ポインターが (訳あって) 要素の _ヒットテスト_ 境界の外へ移動したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointerout", "onpointerout")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointerover_event", "pointerover")}}
  - : ポインターが要素のヒットテスト境界の中へ移動したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointerover", "onpointerover")}} プロパティからも利用できます。
- {{DOMxRef("Document/pointerup_event", "pointerup")}}
  - : ポインターがアクティブではなくなったときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onpointerup", "onpointerup")}} プロパティからも利用できます。

### 選択イベント

- {{DOMxRef("Document/selectionchange_event", "selectionchange")}}
  - : 文書でのテキスト選択範囲が変化したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onselectionchange", "onselectionchange")}} プロパティからも利用できます。
- {{DOMxRef("Document/selectstart_event", "selectstart")}}
  - : ユーザーが新しい選択を開始したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/onselectstart", "onselectstart")}} プロパティからも利用できます。

### タッチイベント

- {{DOMxRef("Document/touchcancel_event", "touchcancel")}}
  - : 1 つ以上のタッチ点が実装固有の方法で中断された場合に発行されます (例えば、作成されたタッチ点が多すぎた場合など)。
    {{DOMxRef("GlobalEventHandlers/ontouchcancel", "ontouchcancel")}} プロパティからも利用できます。
- {{DOMxRef("Document/touchend_event", "touchend")}}
  - : 1 つ以上のタッチ点がタッチ面から取り除かれたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ontouchend", "ontouchend")}} プロパティからも利用できます。
- {{DOMxRef("Document/touchmove_event", "touchmove")}}
  - : 1 つ以上のタッチ点がタッチ面に沿って移動したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ontouchmove", "ontouchmove")}} プロパティからも利用できます。
- {{DOMxRef("Document/touchstart_event", "touchstart")}}
  - : 1 つ以上のタッチ点がタッチ面に配置されたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ontouchstart", "ontouchstart")}} プロパティからも利用できます。

### トランジションイベント

- {{DOMxRef("Document/transitioncancel_event", "transitioncancel")}}
  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)がキャンセルされたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ontransitioncancel", "ontransitioncancel")}} プロパティからも利用できます。
- {{DOMxRef("Document/transitionend_event", "transitionend")}}
  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が完了したときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ontransitionend", "ontransitionend")}} プロパティからも利用できます。
- {{DOMxRef("Document/transitionrun_event", "transitionrun")}}
  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が初めて作成されたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ontransitionrun", "ontransitionrun")}} プロパティからも利用できます。
- {{DOMxRef("Document/transitionstart_event", "transitionstart")}}
  - : Fired when a [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が実際に開始されたときに発行されます。
    {{DOMxRef("GlobalEventHandlers/ontransitionstart", "ontransitionstart")}} プロパティからも利用できます。

## 標準外の拡張 {{Non-standard_Inline}}

{{non-standard_header}}

### Firefox のメモ

Firefox は、いくつかの標準外のメソッドを定義しています。

- {{DOMxRef("Document.execCommandShowHelp()")}} {{deprecated_inline}}
  - : このメソッドは何も行わずに例外が発生することから、 Gecko 14.0 {{geckoRelease("14.0")}} で削除されました。
- {{DOMxRef("Document.getBoxObjectFor()")}} {{deprecated_inline}}
  - : 代わりに {{DOMxRef("Element.getBoundingClientRect()")}} メソッドを使用してください。
- {{DOMxRef("Document.loadOverlay()")}} {{deprecated_inline}}
  - : [XUL overlay](/ja/docs/XUL_Overlays) を動的に読み込みます。これは XUL 文書のみで動作します。
- {{DOMxRef("Document.queryCommandText()")}} {{deprecated_inline}}
  - : このメソッドは何も行わずに例外が発生することから、Gecko 14 {{GeckoRelease("14")}} で削除しました。

### Internet Explorer のメモ

Microsoft は、標準外のプロパティを定義しています。

- {{DOMxRef("Document.fileSize")}}\* {{Non-standard_Inline}} {{deprecated_inline}}
  - : 文書の長さをバイト単位で返します。 Internet Explorer 11 より、このプロパティには対応していません。[MSDN](https://msdn.microsoft.com/ja/library/ms533752%28v=VS.85%29.aspx) をご覧ください。

## 仕様書

{{Specifications}}

## ブラウザーの互換性

{{Compat}}