aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/window/index.html
blob: bf5e8807067f2bfc4d7cd434d5c44e2bebb1fa79 (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
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
---
title: Window
slug: Web/API/Window
tags:
  - API
  - Browser
  - DOM
  - Interface
  - Reference
  - Tab
  - Window
  - global
  - global scope
  - scope
  - インターフェイス
translation_of: Web/API/Window
---
<div>{{APIRef("DOM")}}</div>

<p><span class="seoSummary"><strong><code>Window</code></strong> インターフェイスは、 {{glossary("DOM")}} 文書を収めるウィンドウを表します。 <code>document</code> プロパティは、そのウィンドウに読み込まれた <a href="/ja/docs/Web/API/Document">DOM の document オブジェクト</a> を指します。</span>特定の文書が属するウィンドウは、 {{domxref("document.defaultView")}} プロパティを使用して取得できます。</p>

<p>グローバル変数の <code>window</code> は、スクリプトを実行しているウィンドウを表しており、JavaScript コードに公開されます。</p>

<p><code>Window</code> インターフェイスは、ユーザーインターフェースのウィンドウの概念とは必ずしも直接関連づかない、さまざまな関数、名前空間、オブジェクト、コンストラクターのホームです。一方、 <code>Window</code> インターフェイスはグローバルで使用可能であることが必要な、さまざまなアイテムを含むのに適した場所です。これらの多くは <a href="/ja/docs/Web/JavaScript/Reference">JavaScript リファレンス</a><a href="/ja/docs/Web/API/Document_Object_Model">DOM リファレンス</a> で文書化しています。</p>

<p>タブブラウザーでは、それぞれのタブが個々の <code>Window</code> オブジェクトで表されます。タブ内で実行している JavaScript から見えるグローバルの <code>window</code> は、常にコードを実行しているタブを表します。しかし、タブブラウザーであっても {{Domxref("Window.resizeTo", "resizeTo()")}}{{Domxref("Window.innerHeight", "innerHeight")}} のように、タブを含むウィンドウ全体に適用されるプロパティやメソッドがあります。一般に、タブに所属することができない合理的な理由があるものは、代わりにウィンドウに属します。</p>

<p>{{InheritanceDiagram}}</p>

<h2 id="Constructors" name="Constructors">コンストラクター</h2>

<p><a href="/ja/docs/DOM/DOM_Reference" title="DOM/DOM_Reference">DOM インターフェイス</a>もご覧ください。</p>

<dl>
 <dt>{{domxref("DOMParser")}}</dt>
 <dd><code>DOMParser</code> は文字列で保存された XML や HTML ソースを解析して、 DOM <a href="/ja/docs/DOM/document" title="document">Document</a> に変換できます。 <code>DOMParser</code><a href="https://w3c.github.io/DOM-Parsing/" title="http://html5.org/specs/dom-parsing.html">DOM Parsing and Serialization</a> で定められています。</dd>
 <dt>{{domxref("Image")}}</dt>
 <dd>{{domxref("HTMLImageElement")}} を生成します。</dd>
 <dt>{{domxref("Option")}}</dt>
 <dd>{{domxref("HTMLOptionElement")}} を生成します。</dd>
 <dt>{{domxref("StaticRange")}} {{experimental_inline}} {{readonlyinline}}</dt>
 <dd>{{domxref('StaticRange')}} オブジェクトを作成する {{domxref('StaticRange.StaticRange','StaticRange()')}} コンストラクターを返します。</dd>
 <dt>{{domxref("Worker")}}</dt>
 <dd><a href="/ja/docs/DOM/Using_web_workers">Web worker</a> を生成します。</dd>
 <dt>{{domxref("XMLSerializer")}}</dt>
 <dd>{{todo("NeedsContents")}}</dd>
</dl>

<h2 id="Properties" name="Properties">プロパティ</h2>

<p><em>このインターフェイスは、 {{domxref("EventTarget")}} インターフェイスからプロパティを継承しています。また {{domxref("WindowOrWorkerGlobalScope")}} および {{domxref("WindowEventHandlers")}} ミックスインのプロパティを実装しています。</em></p>

<p>オブジェクトであるプロパティ (例えば、ビルトイン要素のプロトタイプをオーバーライドするためのもの) は、後述の個別セクションに記載しています。</p>

<dl>
 <dt>{{domxref("Window.closed")}} {{Non-standard_inline}} {{readOnlyInline}}</dt>
 <dd>このプロパティは、現在のウィンドウが閉じているかどうかを示します。</dd>
 <dt>{{domxref("Window.console")}} {{ReadOnlyInline}}</dt>
 <dd>ブラウザーのデバッグコンソールへアクセスするための console オブジェクトへの参照を返します。</dd>
 <dt>{{domxref("Window.controllers")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt>
 <dd>現在の chrome ウィンドウの XUL controller オブジェクトを返します。</dd>
 <dt>{{domxref("Window.customElements")}} {{ReadOnlyInline}}</dt>
 <dd>{{domxref("CustomElementRegistry")}} オブジェクトへの参照を返します。これは新しい<a href="/ja/docs/Web/Web_Components/Using_custom_elements">カスタム要素</a>の登録や、以前に登録したカスタム要素の情報を取得するために使用できます。</dd>
 <dt>{{domxref("Window.crypto")}} {{readOnlyInline}}</dt>
 <dd>ブラウザーの crypto オブジェクトを返します。</dd>
 <dt>{{domxref("Window.devicePixelRatio")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt>
 <dd>現在のディスプレイの、物理ピクセルと端末非依存ピクセルの比率を返します。</dd>
 <dt>{{domxref("Window.dialogArguments")}} {{ReadOnlyInline}}</dt>
 <dd>{{domxref("window.showModalDialog()")}} メソッドが呼び出されたときにウィンドウ (それがダイアログボックスである場合) に渡された引数を取得。これは {{Interface("nsIArray")}} インタフェースです。</dd>
 <dt>{{domxref("Window.document")}} {{ReadOnlyInline}}</dt>
 <dd>指定ウィンドウが含む文書への参照を返す</dd>
 <dt>{{domxref("Window.DOMMatrix")}} {{readOnlyInline}} {{experimental_inline}}</dt>
 <dd>{{domxref("DOMMatrix")}} オブジェクトへの参照を返します。これは 4x4 のマトリックスを表し、 2D や 3D の操作に適しています。</dd>
 <dt>{{domxref("Window.DOMMatrixReadOnly")}} {{readOnlyInline}} {{experimental_inline}}</dt>
 <dd>{{domxref("DOMMatrixReadOnly")}} オブジェクトへの参照を返します。これは 4x4 のマトリックスを表し、2D や 3D の操作に適しています。</dd>
 <dt>{{domxref("Window.DOMPoint")}} {{readOnlyInline}} {{experimental_inline}}</dt>
 <dd>{{domxref("DOMPoint")}} オブジェクトへの参照を返します。これはある座標系での 2D や 3D の点を表します。</dd>
 <dt>{{domxref("Window.DOMPointReadOnly")}} {{readOnlyInline}} {{experimental_inline}}</dt>
 <dd>{{domxref("DOMPointReadOnly")}} オブジェクトへの参照を返します。これは座標系で 2D や 3D の点を表します。</dd>
 <dt>{{domxref("Window.DOMQuad")}} {{readOnlyInline}} {{experimental_inline}}</dt>
 <dd>{{domxref("DOMQuad")}} オブジェクトへの参照を返します。これは 4 つの角と辺からなる四角形オブジェクトを表します。</dd>
 <dt>{{domxref("Window.DOMRect")}} {{readOnlyInline}} {{experimental_inline}}</dt>
 <dd>{{domxref("DOMRect")}} オブジェクトへの参照を返します。これは長方形を表します。</dd>
 <dt>{{domxref("Window.DOMRectReadOnly")}} {{readOnlyInline}} {{experimental_inline}}</dt>
 <dd>{{domxref("DOMRectReadOnly")}} オブジェクトへの参照を返します。これは長方形を表します。</dd>
 <dt>{{domxref("Window.event")}} {{ReadOnlyInline}}</dt>
 <dd><strong>現在のイベント</strong> を返します。これは現在 JavaScript のコードのコンテキストが処理しているイベントです。また、現在処理しているイベントがない場合は <code>undefined</code> を返します。イベントハンドラーに直接渡した {{domxref("Event")}} オブジェクトは、可能な限り代わりに使用するべきです。</dd>
 <dt>{{domxref("Window.frameElement")}} {{readOnlyInline}}</dt>
 <dd>ウィンドウが埋め込まれた要素を返す。ウィンドウが埋め込まれていない場合は、 null を返す。</dd>
 <dt>{{domxref("Window.frames")}} {{readOnlyInline}}</dt>
 <dd>現在のウィンドウでのサブフレームの配列を返します。</dd>
 <dt>{{domxref("Window.fullScreen")}}</dt>
 <dd>このプロパティはウィンドウが全画面で表示されているかどうかを示します。</dd>
 <dt>{{domxref("Window.history")}} {{ReadOnlyInline}}</dt>
 <dd>history オブジェクトへの参照を返す</dd>
 <dt>{{domxref("Window.innerHeight")}} {{readOnlyInline}}</dt>
 <dd>ブラウザーウィンドウのコンテンツ領域の高さを取得し、もしあれば、水平スクロールバーを含みます。</dd>
 <dt>{{domxref("Window.innerWidth")}} {{readOnlyInline}}</dt>
 <dd>ブラウザーウィンドウのコンテンツ領域の幅を取得し、もしあれば、垂直スクロールバーを含みます。</dd>
 <dt>{{domxref("Window.isSecureContext")}} {{experimental_inline}} {{readOnlyInline}}</dt>
 <dd>コンテキストが、安全なコンテキストを必要とする機能を使用することができるかどうかを表します。</dd>
 <dt>{{domxref("Window.length")}} {{readOnlyInline}}</dt>
 <dd>ウィンドウ内のフレームの数を返します。 {{domxref("window.frames")}} も参照してください。</dd>
 <dt>{{domxref("Window.location")}}</dt>
 <dd>window オブジェクトのロケーション、または現在の URL を取得 / 設定します。</dd>
 <dt>{{domxref("Window.locationbar")}} {{ReadOnlyInline}}</dt>
 <dd>ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な locationbar オブジェクトを返す</dd>
 <dt>{{domxref("Window.localStorage")}} {{readOnlyInline}}</dt>
 <dd>生成元のオリジンからのみアクセスが可能なデータを保存するために使用する、ローカルストレージオブジェクトへの参照を返します。</dd>
 <dt>{{domxref("Window.menubar")}} {{ReadOnlyInline}}</dt>
 <dd>ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な menubar オブジェクトを返す</dd>
 <dt>{{domxref("Window.messageManager")}}</dt>
 <dd>このウィンドウの <a href="/ja/docs/The_message_manager">message manager</a> オブジェクトを返します。</dd>
 <dt>{{domxref("Window.mozInnerScreenX")}} {{ReadOnlyInline}} {{non-standard_inline}}</dt>
 <dd>スクリーン座標系でウィンドウのビューポートの左上隅の水平 (X) 座標を返します。この値は CSS ピクセルで表します。必要に応じて画面のピクセルに換算するための係数については、{{interface("nsIDOMWindowUtils")}}<code>mozScreenPixelsPerCSSPixel</code> をご覧ください。</dd>
 <dt>{{domxref("Window.mozInnerScreenY")}} {{ReadOnlyInline}} {{non-standard_inline}}</dt>
 <dd>スクリーン座標系で、ウィンドウビューポートの左上隅の垂直 (Y) 座標を返します。この値は CSS ピクセルで表します。必要に応じて画面のピクセルに換算するための係数については <code>mozScreenPixelsPerCSSPixel</code> をご覧ください。</dd>
 <dt>{{domxref("Window.name")}}</dt>
 <dd>ウィンドウ名を取得 / 設定します。</dd>
 <dt>{{domxref("Window.navigator")}} {{readOnlyInline}}</dt>
 <dd>navigator オブジェクトへの参照を返します。</dd>
 <dt>{{domxref("Window.opener")}}</dt>
 <dd>現在のウィンドウを開いたウィンドウへの参照を返します。</dd>
 <dt>{{domxref("Window.orientation")}} {{non-standard_inline}} {{deprecated_inline}} {{readOnlyInline}}</dt>
 <dd>端末の本来の向きに対して相対的なビューポートの向きを角度 (90 度単位) で返します。</dd>
 <dt>{{domxref("Window.outerHeight")}} {{readOnlyInline}}</dt>
 <dd>ブラウザーウィンドウの外側の高さを取得します。</dd>
 <dt>{{domxref("Window.outerWidth")}} {{readOnlyInline}}</dt>
 <dd>ブラウザーウィンドウの外側の幅を取得します。</dd>
 <dt>{{domxref("Window.scrollX","Window.pageXOffset")}} {{readOnlyInline}}</dt>
 <dd>{{domxref("window.scrollX")}} のエイリアスです。</dd>
 <dt>{{domxref("Window.scrollY","Window.pageYOffset")}} {{readOnlyInline}}</dt>
 <dd>{{domxref("window.scrollY")}} のエイリアスです。</dd>
 <dt>{{domxref("Window.parent")}} {{readOnlyInline}}</dt>
 <dd>現在のウィンドウまたはサブフレームの親ウィンドウへの参照を返します。</dd>
 <dt>{{domxref("Window.performance")}} {{readOnlyInline}}</dt>
 <dd>{{domxref("Performance")}} オブジェクトを返します。これは {{domxref("Performance.timing", "timing")}}{{domxref("Performance.navigation", "navigation")}} 属性が含まれており、それぞれが <a href="/ja/docs/Navigation_timing">パフォーマンス関連</a> のデータを提供するオブジェクトです。詳細情報や使用例は <a href="/ja/docs/Web/API/Navigation_timing_API/Using_Navigation_Timing">Using Navigation Timing</a> をご覧ください。</dd>
 <dt>{{domxref("Window.personalbar")}} {{readOnlyInline}}</dt>
 <dd>ウィンドウ内で表示/非表示の切り替え (トグル) が可能な、 personalbar オブジェクトを返す</dd>
 <dt>{{domxref("Window.screen")}} {{readOnlyInline}}</dt>
 <dd>ウィンドウに関連付けられた screen オブジェクトへの参照を返す</dd>
 <dt>{{domxref("Window.screenX")}} および {{domxref("Window.screenLeft")}} {{readOnlyInline}}</dt>
 <dd>どちらのプロパティも、ユーザーのブラウザーのビューポートの左端から画面の左端までの水平方向の距離を返します。</dd>
 <dt>{{domxref("Window.screenY")}} および {{domxref("Window.screenTop")}} {{readOnlyInline}}</dt>
 <dd>どちらのプロパティも、ユーザーのブラウザーのビューポートの上端から画面の上端までの垂直方向の距離を返します。</dd>
 <dt>{{domxref("Window.scrollbars")}} {{readOnlyInline}}</dt>
 <dd>ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な、 scrollbars オブジェクトを返す</dd>
 <dt>{{domxref("Window.scrollMaxX")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt>
 <dd>ウィンドウが水平スクロールされ得る最大オフセット、すなわち、文書の幅からビューポートの幅を引いたものです。</dd>
 <dt>{{domxref("Window.scrollMaxY")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt>
 <dd>ウィンドウが垂直スクロールされ得る最大オフセット (すなわち、文書の高さからビューポートの高さを引いたもの) です。</dd>
 <dt>{{domxref("Window.scrollX")}} {{readOnlyInline}}</dt>
 <dd>文書が現在水平にスクロールされているピクセル数を返します。</dd>
 <dt>{{domxref("Window.scrollY")}} {{readOnlyInline}}</dt>
 <dd>文書が現在垂直にスクロールされているピクセル数を返します。</dd>
 <dt>{{domxref("Window.self")}} {{ReadOnlyInline}}</dt>
 <dd>window オブジェクト自身へのオブジェクト参照を返す</dd>
 <dt>{{domxref("Window.sessionStorage")}}</dt>
 <dd>生成元のオリジンからのみアクセスが可能なデータを保存するために使用する、セッションストレージへの参照を返します。</dd>
 <dt>{{domxref("Window.sidebar")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt>
 <dd>サイドバーの window オブジェクトへの参照を返します。</dd>
 <dt>{{domxref("Window.speechSynthesis")}} {{ReadOnlyInline}}</dt>
 <dd>{{domxref("SpeechSynthesis")}} オブジェクトを返します。これは、<a href="/ja/docs/Web/API/Web_Speech_API">Web Speech API</a> の音声合成機能を使用するためのエントリーポイントです。</dd>
 <dt>{{domxref("Window.status")}}</dt>
 <dd>ブラウザー下部のステータスバーのテキストを取得 / 設定します。</dd>
 <dt>{{domxref("Window.statusbar")}} {{readOnlyInline}}</dt>
 <dd>ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な statusbar オブジェクトを返します。</dd>
 <dt>{{domxref("Window.toolbar")}} {{readOnlyInline}}</dt>
 <dd>ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な toolbar オブジェクトを返します。</dd>
 <dt>{{domxref("Window.top")}} {{readOnlyInline}}</dt>
 <dd>ウィンドウ階層における最上位のウィンドウへの参照を返します。このプロパティは読み取り専用です。</dd>
 <dt>{{domxref("Window.visualViewport")}} {{readOnlyInline}}</dt>
 <dd>指定したウィンドウの視覚的なビューポートを表す {{domxref("VisualViewport")}} オブジェクトを返します。</dd>
 <dt>{{domxref("Window.window")}} {{ReadOnlyInline}}</dt>
 <dd>現在のウィンドウへの参照を返します。</dd>
 <dt><code>window[0]</code><code>window[1]</code> など</dt>
 <dd>フレーム内の <code>window</code> オブジェクトへの参照を返します。詳しくは {{domxref("Window.frames")}} をご覧ください。</dd>
</dl>

<h3 id="Properties_implemented_from_elsewhere" name="Properties_implemented_from_elsewhere">他のところで実装されているプロパティ</h3>

<dl>
 <dt>{{domxref("WindowOrWorkerGlobalScope.caches")}} {{readOnlyinline}}</dt>
 <dd>現在のコンテキストに関連付けられた {{domxref("CacheStorage")}} オブジェクトを返します。このオブジェクトはオフラインで使用する資産を格納したり、リクエストに対して独自のレスポンスを生成したりするような機能が利用できます。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.indexedDB")}} {{readonlyInline}}</dt>
 <dd>Indexed データベースにアプリケーションが非同期にアクセスできる仕組みを提供します。このプロパティは {{domxref("IDBFactory")}} オブジェクトを返します。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.isSecureContext")}} {{readOnlyinline}}</dt>
 <dd>現在のコンテキストが安全である (<code>true</code>) か否か (<code>false</code>) を示す論理値を返します。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.origin")}} {{readOnlyinline}}</dt>
 <dd>グローバルオブジェクトのオリジンを、文字列としてシリアライズして返します。 (これはまだどのブラウザーでも実装されていません。)</dd>
</dl>

<h3 id="Obsolete_properties" name="Obsolete_properties">廃止されたプロパティ</h3>

<dl>
 <dt>{{domxref("Window.content")}} および <code>Window._content</code> {{Non-standard_inline}} {{obsolete_inline}} {{ReadOnlyInline}}</dt>
 <dd>現在のウィンドウでのコンテンツ要素への参照を返します。 Firefox 57 より (当初は Nightly のみ) どちらも chrome (特権付き) コードに限り使用でき、ウェブでは使用できません。</dd>
 <dt>{{domxref("Window.defaultStatus")}} {{obsolete_inline}}</dt>
 <dd>指定ウィンドウのステータスバーのテキストを取得 / 設定</dd>
 <dt>{{domxref("Window.directories")}} {{obsolete_inline}}</dt>
 <dd>{{domxref("window.personalbar")}} と同義</dd>
 <dt>{{domxref("Window.globalStorage")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>複数のページに渡ってデータを保存するために使用する、複数のストレージオブジェクトを表していました。</dd>
 <dt>{{domxref("Window.mozAnimationStartTime")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>現在のアニメーションサイクルが開始したときから経過した時間をミリ秒単位で表します。代わりに {{domxref("Animation.startTime")}} を使用してください。</dd>
 <dt>{{domxref("Window.mozPaintCount")}} {{non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>当該ウィンドウで、現在の文書を画面に描画した回数を返します。これは、描画パフォーマンスの算定に使用できます。</dd>
 <dt>{{domxref("Window.pkcs11")}} {{obsolete_inline}}</dt>
 <dd>PKCS11 モジュールのインストールや削除を行う機能を提供していました。</dd>
 <dt>{{domxref("Window.returnValue")}} {{obsolete_inline}}</dt>
 <dd>ウィンドウをモーダルダイアログとして表示する {{domxref("window.showModalDialog()")}} メソッドを呼び出した関数へ返却される返値です。</dd>
</dl>

<h2 id="Methods" name="Methods">メソッド</h2>

<p><em>このインターフェイスは {{domxref("EventTarget")}} インターフェイスからメソッドを継承します。また {{domxref("WindowOrWorkerGlobalScope")}} および {{domxref("EventTarget")}} のプロパティを実装します。</em></p>

<dl>
 <dt>{{domxref("Window.alert()")}}</dt>
 <dd>警告ダイアログを表示します。</dd>
 <dt>{{domxref("Window.blur()")}}</dt>
 <dd>ウィンドウからフォーカスを外します。</dd>
 <dt>{{domxref("Window.cancelAnimationFrame()")}} {{experimental_inline}}</dt>
 <dd>{{domxref("Window.requestAnimationFrame")}} によって過去にスケジューリングされたコールバックをキャンセルできます。</dd>
 <dt>{{domxref("Window.cancelIdleCallback()")}} {{experimental_inline}}</dt>
 <dd>{{domxref("Window.requestIdleCallback")}} によって過去にスケジューリングされたコールバックをキャンセルできます。</dd>
 <dt>{{domxref("Window.clearImmediate()")}}</dt>
 <dd><code>setImmediate</code> で設定した繰り返し処理をキャンセルします。</dd>
 <dt>{{domxref("Window.close()")}}</dt>
 <dd>現在のウィンドウを閉じます。</dd>
 <dt>{{domxref("Window.confirm()")}}</dt>
 <dd>ユーザーの応答が必要なメッセージを持つダイアログを表示します。</dd>
 <dt>{{domxref("Window.dump()")}} {{Non-standard_inline}}</dt>
 <dd>コンソールにメッセージを出力します。</dd>
 <dt>{{domxref("Window.find()")}}</dt>
 <dd>ウィンドウ内で指定された文字列を検索します。</dd>
 <dt>{{domxref("Window.focus()")}}</dt>
 <dd>現在のウィンドウにフォーカスを当てます。</dd>
 <dt>{{domxref("Window.getComputedStyle()")}}</dt>
 <dd>特定の要素の計算済みスタイルを取得します。計算済みスタイルは、要素のすべての CSS プロパティの計算値を示します。</dd>
 <dt>{{domxref("Window.getDefaultComputedStyle()")}} {{Non-standard_inline}}</dt>
 <dd>特定の要素について、作者のスタイルシートを無視したデフォルトの計算済みスタイルを取得します。</dd>
 <dt>{{domxref("Window.getSelection()")}}</dt>
 <dd>選択されたアイテムを表す、セレクションオブジェクトを返します。</dd>
 <dt>{{domxref("Window.matchMedia()")}}</dt>
 <dd>指定したメディアクエリ文字列を表す {{domxref("MediaQueryList")}} オブジェクトを返します。</dd>
 <dt>{{domxref("Window.maximize()")}}</dt>
 <dd>{{todo("NeedsContents")}}</dd>
 <dt>{{domxref("Window.minimize()")}} (最上位の XUL ウィンドウに限る)</dt>
 <dd>ウィンドウを最小化します。</dd>
 <dt>{{domxref("Window.moveBy()")}}</dt>
 <dd>現在のウィンドウを指定した距離移動します。</dd>
 <dt>{{domxref("Window.moveTo()")}}</dt>
 <dd>ウィンドウを指定した位置に移動します。</dd>
 <dt>{{domxref("Window.open()")}}</dt>
 <dd>新しいウィンドウを開きます。</dd>
 <dt>{{domxref("Window.postMessage()")}}</dt>
 <dd>あるウィンドウから別のウィンドウへ、安全にデータ文字列を送信する手段を提供します。送信先ウィンドウは、送信元と同じドメインでなくてもかまいません。</dd>
 <dt>{{domxref("Window.print()")}}</dt>
 <dd>現在の文書を印刷するためのダイアログを開きます。</dd>
 <dt>{{domxref("Window.prompt()")}}</dt>
 <dd>ユーザーが入力ダイアログに入力したテキストを返します。</dd>
 <dt>{{domxref("Window.requestAnimationFrame()")}}</dt>
 <dd>アニメーションが進行中であることをブラウザーに伝えて、次のアニメーションフレームのためにウィンドウの再描画を予定するよう要求します。</dd>
 <dt>{{domxref("Window.requestIdleCallback()")}} {{experimental_inline}}</dt>
 <dd>ブラウザーがアイドル状態であるときに実行するタスクをスケジューリングします。</dd>
 <dt>{{domxref("Window.resizeBy()")}}</dt>
 <dd>現在のウィンドウを、指定した大きさの分だけ変更します。</dd>
 <dt>{{domxref("Window.resizeTo()")}}</dt>
 <dd>ウィンドウを動的にリサイズします。</dd>
 <dt>{{domxref("Window.scroll()")}}</dt>
 <dd>ウィンドウを文書内の特定の位置にスクロールします。</dd>
 <dt>{{domxref("Window.scrollBy()")}}</dt>
 <dd>ウィンドウ内の文書を、指定した距離の分だけスクロールします。</dd>
 <dt>{{domxref("Window.scrollByLines()")}} {{Non-standard_inline}}</dt>
 <dd>文書を指定した行数分、スクロールします。</dd>
 <dt>{{domxref("Window.scrollByPages()")}} {{Non-standard_inline}}</dt>
 <dd>文書を指定したページ数分、スクロールします。</dd>
 <dt>{{domxref("Window.scrollTo()")}}</dt>
 <dd>文書内の特定の位置に、ウィンドウをスクロールします。</dd>
 <dt>{{domxref("Window.setCursor()")}} {{Non-standard_inline}} (トップレベルの XUL ウィンドウに限る)</dt>
 <dd>現在のウィンドウのカーソルを変更します。</dd>
 <dt>{{domxref("Window.setImmediate()")}}</dt>
 <dd>ブラウザーで他の高負荷なタスクが完了した後に、関数を実行します。</dd>
 <dt>{{domxref("Window.setResizable()")}} {{Non-standard_inline}}</dt>
 <dd>ユーザーがウィンドウをリサイズできるかを切り替えます。</dd>
 <dt>{{domxref("Window.sizeToContent()")}} {{Non-standard_inline}}</dt>
 <dd>コンテンツに応じてウィンドウのサイズを調整します。</dd>
 <dt>{{domxref("Window.stop()")}}</dt>
 <dd>ウィンドウの読み込み処理を停止します。</dd>
 <dt>{{domxref("Window.updateCommands()")}} {{Non-standard_inline}}</dt>
 <dd>現在の chrome ウィンドウ (UI) のコマンドの状態を更新します。</dd>
</dl>

<h3 id="Methods_implemented_from_elsewhere" name="Methods_implemented_from_elsewhere">他のところで実装されているメソッド</h3>

<dl>
 <dt>{{domxref("EventTarget.addEventListener()")}}</dt>
 <dd>ウィンドウの特定の種類のイベントにイベントハンドラーを登録します。</dd>
 <dt>{{domxref("EventTarget.dispatchEvent()")}}</dt>
 <dd>イベントを動作させるために使用します。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.atob()")}}</dt>
 <dd>Base64 エンコーディングを使用してエンコードされたデータの文字列をデコードします。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.btoa()")}}</dt>
 <dd>バイナリデータを Base64 でエンコードした ASCII 文字列を生成します。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.clearInterval()")}}</dt>
 <dd>{{domxref("WindowOrWorkerGlobalScope.setInterval()")}} で繰り返し実行されるよう設定された命令をキャンセルします。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.clearTimeout()")}}</dt>
 <dd>{{domxref("WindowOrWorkerGlobalScope.setTimeout()")}} で遅延実行するよう設定した命令をキャンセルします。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.createImageBitmap()")}}</dt>
 <dd>さまざまな画像ソースを受け入れて、{{domxref("ImageBitmap")}} に解決される {{domxref("Promise")}} を返します。任意で、始点 <em>(sx, sy)</em> から幅 sw、高さ sh の長方形でソースを切り抜くことができます。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.fetch()")}}</dt>
 <dd>ネットワークからリソースを取り込む処理を開始します。</dd>
 <dt>{{domxref("EventTarget.removeEventListener")}}</dt>
 <dd>window からイベントリスナーを削除します。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.setInterval()")}}</dt>
 <dd>ミリ秒単位で指定した時間が経過するたびに関数を実行するようスケジューリングします。</dd>
 <dt>{{domxref("WindowOrWorkerGlobalScope.setTimeout()")}}</dt>
 <dd>指定した時間が経過したら関数を実行するようスケジューリングします。</dd>
</dl>

<h3 id="Obsolete_methods" name="Obsolete_methods">廃止されたメソッド</h3>

<dl>
 <dt>{{domxref("Window.back()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>ウィンドウの履歴をひとつ戻ります。このメソッドは廃止されました。代わりに {{domxref("History.back", "window.history.back()")}} を使用してください。</dd>
 <dt>{{domxref("Window.captureEvents()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>特定のタイプのイベントをすべてキャプチャするよう、ウィンドウに登録します。</dd>
 <dt>{{domxref("Window.forward()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>履歴でひとつ先の文書に移動します。このメソッドは廃止されました。代わりに {{domxref("History.forward", "window.history.forward()")}} を使用してください。</dd>
 <dt>{{domxref("Window.getAttention()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>アプリケーションアイコンをフラッシュさせます。</dd>
 <dt>{{domxref("Window.home()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>ブラウザーのホームページに戻ります。</dd>
 <dt>{{domxref("Window.openDialog()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>新しいダイアログウィンドウを開きます。</dd>
 <dt>{{domxref("Window.releaseEvents()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>特定のタイプのイベントのキャプチャを解放します。</dd>
 <dt>{{domxref("Window.showModalDialog()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>モーダルダイアログを表示します。</dd>
</dl>

<h2 id="Event_handlers" name="Event_handlers">イベントハンドラー</h2>

<p>これらは window オブジェクトのプロパティで、ウィンドウで発生する可能性がある、関心事となる可能性がある様々な出来事に対するイベントハンドラーを設定して有効にすることができます。</p>

<p><em>このインターフェイスは、 {{domxref("EventTarget")}} インターフェイスからイベントハンドラーを継承しています。また {{domxref("WindowEventHandlers")}} のイベントハンドラーを実装ていします。</em></p>

<div class="note">
<p><strong>メモ:</strong> {{Gecko("9.0")}} より、あるイベントハンドラープロパティが存在するかを調べるために <code>if ("onabort" in window)</code> という構文を使用できます。これは、 web IDL インターフェイスを適正にするためにイベントハンドラーインターフェイスが更新されたためです。詳しくは <a href="/ja/docs/DOM/DOM_event_handlers">DOM のイベントハンドラー</a>をご覧ください。</p>
</div>

<dl>
 <dt>{{domxref("Window.onappinstalled")}}</dt>
 <dd>ページがウェブアプリとしてインストールされたときに呼び出されます。 {{domxref("Window/appinstalled_event", "appinstalled")}} イベントをご覧ください。</dd>
 <dt>{{domxref("Window.onbeforeinstallprompt")}}</dt>
 <dd>モバイル環境でウェブサイトをホーム画面に保存するかどうかをユーザーに尋ねる前に呼び出されるイベントハンドラープロパティです。</dd>
 <dt>{{domxref("Window.ondevicelight")}}</dt>
 <dd>環境光のレベルが変化したイベントのイベントハンドラープロパティです。</dd>
 <dt>{{domxref("Window.ondevicemotion")}}</dt>
 <dd>加速度センサーが変化を検知した場合に呼び出されます (モバイル端末向け)</dd>
 <dt>{{domxref("Window.ondeviceorientation")}}</dt>
 <dd>向きが変化したときに呼び出されます (モバイル端末向け)</dd>
 <dt>{{domxref("Window.ondeviceorientationabsolute")}} {{non-standard_inline}}</dt>
 <dd>端末の向きが変化したイベントのイベントハンドラープロパティです。</dd>
 <dt>{{domxref("Window.ondeviceproximity")}}</dt>
 <dd>端末の proximity イベントのイベントハンドラープロパティです。</dd>
 <dt>{{domxref("Window.ongamepadconnected")}}</dt>
 <dd>ゲームパッドがコンピューターに接続された ({{event('gamepadconnected')}} イベントが発生した) ときに実行するイベントハンドラーを表します。</dd>
 <dt>{{domxref("Window.ongamepaddisconnected")}}</dt>
 <dd>ゲームパッドがコンピューターから取り外された ({{event('gamepaddisconnected')}} イベントが発生した) ときに実行するイベントハンドラーを表します。</dd>
 <dt>{{domxref("Window.onmozbeforepaint")}}</dt>
 <dd><code>MozBeforePaint</code> イベントのイベントハンドラープロパティです。 {{domxref("Window.mozRequestAnimationFrame()")}} メソッドの呼び出しによってイベントが要求された場合に、ウィンドウを再描画する前に送信されます。</dd>
 <dt>{{domxref("Window.onpaint")}}</dt>
 <dd>ウィンドウの描画イベントのイベントハンドラーです。</dd>
 <dt>{{domxref("Window.onrejectionhandled")}} {{experimental_inline}}</dt>
 <dd>{{jsxref("Promise")}} の失敗イベントを扱うためのイベントハンドラープロパティです。</dd>
 <dt>{{domxref("Window.onuserproximity")}}</dt>
 <dd>ユーザーの近接イベントのためのイベントハンドラープロパティです。</dd>
 <dt>{{domxref("Window.onvrdisplayconnect")}}</dt>
 <dd>互換性がある VR 端末がコンピューターに接続された ({{event("vrdisplayconnected")}} イベントが発生した) ときに実行するイベントハンドラーを表します。</dd>
 <dt>{{domxref("Window.onvrdisplaydisconnect")}}</dt>
 <dd>互換性がある VR 端末がコンピューターから取り外された ({{event("vrdisplaydisconnected")}} イベントが発生した) ときに実行するイベントハンドラーを表します。</dd>
 <dt>{{domxref("Window.onvrdisplayactivate")}}</dt>
 <dd>HMD がスタンバイ状態から復帰した、あるいは装着によって起動したなどにより、ディスプレイが実行可能になった ({{event("vrdisplayactivate")}} イベントが発生) ときに実行するイベントハンドラーを表します。</dd>
 <dt>{{domxref("Window.onvrdisplaydeactivate")}}</dt>
 <dd>HMD が未使用時間によってスタンバイ状態やスリープ状態に移行したなど、ディスプレイが実行可能状態ではなくなった ({{event("vrdisplaydeactivate")}} イベントが発生) ときに実行するイベントハンドラーを表します。</dd>
 <dt>{{domxref("Window.onvrdisplayblur")}}</dt>
 <dd>ユーザーがシステムメニューやブラウザーを操作している間に追跡を妨げたり体験が失われたりするなど、ブラウザー、OS、VR ハードウェアによるなんらかの理由でディスプレーの表示が一時停止した ({{event("vrdisplayblur")}} イベントが発生) ときに実行するイベントハンドラーを表します。</dd>
 <dt>{{domxref("Window.onvrdisplayfocus")}}</dt>
 <dd>ディスプレイの表示が blur 状態から復帰した ({{event("vrdisplayfocus")}} イベントが発生) ときに実行するイベントハンドラーを表します。</dd>
 <dt>{{domxref("Window.onvrdisplaypresentchange")}}</dt>
 <dd>表示状態から非表示状態に変化した、あるいはその逆の変化など、VR 端末の表示状態が変化した ({{event("vrdisplaypresentchange")}} イベントが発生) ときに実行するイベントハンドラーを表します。</dd>
</dl>

<h3 id="Event_handlers_implemented_from_elsewhere" name="Event_handlers_implemented_from_elsewhere">他で実装されているイベントハンドラー</h3>

<dl>
 <dt>{{domxref("GlobalEventHandlers.onabort")}}</dt>
 <dd>ユーザーが読み込み処理中にキャンセルしたなど、リソースの読み込みが異常終了した際に呼び出されます。</dd>
 <dt>{{domxref("WindowEventHandlers.onafterprint")}}</dt>
 <dd>印刷ダイアログボックスを閉じたときに呼び出されます。{{event("afterprint")}} イベントをご覧ください。</dd>
 <dt>{{domxref("WindowEventHandlers.onbeforeprint")}}</dt>
 <dd>印刷ダイアログボックスを開いたときに呼び出されます。{{event("beforeprint")}} イベントをご覧ください。</dd>
 <dt>{{domxref("WindowEventHandlers.onbeforeunload")}}</dt>
 <dd>window でイベントをアンロードする前のイベントハンドラープロパティです。</dd>
 <dt>{{domxref("GlobalEventHandlers.onblur")}}</dt>
 <dd>ポップアップなどにより、ウィンドウがフォーカスを失った後に呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onchange")}}</dt>
 <dd>window の change イベントのイベントハンドラープロパティです。</dd>
 <dt>{{domxref("GlobalEventHandlers.onclick")}}</dt>
 <dd>いずれかのマウスボタンを押した後および離した後に呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.ondblclick")}}</dt>
 <dd>いずれかのマウスボタンをダブルクリックしたときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onclose")}}</dt>
 <dd>ウィンドウを閉じた後に呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.oncontextmenu")}}</dt>
 <dd>右マウスボタンを押したときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onerror")}}</dt>
 <dd>リソースの読み込みが失敗したとき、あるいは実行時にエラーが発生したときに呼び出されます。{{event("error")}} イベントをご覧ください。</dd>
 <dt>{{domxref("GlobalEventHandlers.onfocus")}}</dt>
 <dd>ウィンドウがフォーカスを得た、あるいは取り戻した後に呼び出されます。{{event("focus")}} イベントをご覧ください。</dd>
 <dt>{{domxref("WindowEventHandlers.onhashchange")}} {{gecko_minversion_inline("1.9.2")}}</dt>
 <dd>window の {{event('hashchange')}} イベントのイベントハンドラープロパティです。URL のハッシュ記号 ("#") の後の部分が変化したときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.oninput")}}</dt>
 <dd>&lt;input&gt; 要素の値が変化したときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onkeydown")}}</dt>
 <dd>なんらかのキーを押下し始めたときに呼び出されます。{{event("keydown")}} イベントをご覧ください。</dd>
 <dt>{{domxref("GlobalEventHandlers.onkeypress")}}</dt>
 <dd>キー (Shift、Fn、CapsLock を除く) を押下した状態であるときに呼び出されます。{{event("keypress")}} をご覧ください。</dd>
 <dt>{{domxref("GlobalEventHandlers.onkeyup")}}</dt>
 <dd>なんらかのキーを押し終えたときに呼び出されます。{{event("keyup")}} イベントをご覧ください。</dd>
 <dt>{{domxref("WindowEventHandlers.onlanguagechange")}}</dt>
 <dd>window の {{event("languagechange")}} イベントのイベントハンドラープロパティです。</dd>
 <dt>{{domxref("GlobalEventHandlers.onload")}}</dt>
 <dd>すべてのリソースおよび DOM が完全に読み込まれた後に呼び出されます。戻るボタンなどで、キャッシュからページが読み込まれたときは呼び出されません。</dd>
 <dt>{{domxref("WindowEventHandlers.onmessage")}}</dt>
 <dd>{{event("message")}} イベントが発生したときに呼び出すコードを表す {{domxref("EventHandler")}} です。</dd>
 <dt>{{domxref("GlobalEventHandlers.onmousedown")}}</dt>
 <dd>いずれかのマウスボタンを押したときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onmousemove")}}</dt>
 <dd>マウスをウィンドウ内で動かすときに、連続的に呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onmouseout")}}</dt>
 <dd>マウスポインターがウィンドウから外れたときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onmouseover")}}</dt>
 <dd>マウスポインターがウィンドウ内に入ったときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onmouseup")}}</dt>
 <dd>いずれかのマウスボタンを離したときに呼び出されます。</dd>
 <dt>{{domxref("WindowEventHandlers.onoffline")}}</dt>
 <dd>ネットワーク接続が失われたときに呼び出されます。{{event("offline")}} イベントをご覧ください。</dd>
 <dt>{{domxref("WindowEventHandlers.ononline")}}</dt>
 <dd>ネットワーク接続が確立されたときに呼び出されます。{{event("online")}} イベントをご覧ください。</dd>
 <dt>{{domxref("WindowEventHandlers.onpagehide")}}</dt>
 <dd>ユーザーがあるページから去ったとき、onunload イベントの前に呼び出されます。{{event("pagehide")}} イベントをご覧ください。</dd>
 <dt>{{domxref("WindowEventHandlers.onpageshow")}}</dt>
 <dd>すべてのリソースおよび DOM が完全に読み込まれた後に呼び出されます。{{event("pageshow")}} イベントをご覧ください。</dd>
 <dt>{{domxref("WindowEventHandlers.onpopstate")}}</dt>
 <dd>戻るボタンが押されたときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onreset")}}</dt>
 <dd>フォームがリセットされたときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onresize")}}</dt>
 <dd>ウィンドウのリサイズに応じて、連続的に呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onscroll")}}</dt>
 <dd>なんらかの方法でスクロールバーが動かされたときに呼び出されます。リソースがウィンドウ内に完全に収まっている場合は、このイベントを発生させられません。</dd>
 <dt>{{domxref("GlobalEventHandlers.onwheel")}}</dt>
 <dd>マウスホイールがいずれかの軸に沿って回されたときに呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onselect")}}</dt>
 <dd>入力フィールド内のテキストが選択された後に呼び出されます。</dd>
 <dt>{{domxref("GlobalEventHandlers.onselectionchange")}}</dt>
 <dd>{{event("selectionchange")}} イベントが発生したときに呼び出すコードを表す {{domxref("EventHandler")}} です。</dd>
 <dt>{{domxref("WindowEventHandlers.onstorage")}}</dt>
 <dd>セッションストレージまたはローカルストレージが変化したときに呼び出されます。 {{event("storage")}} イベントをご覧ください。</dd>
 <dt>{{domxref("GlobalEventHandlers.onsubmit")}}</dt>
 <dd>フォームが送信されたときに呼び出されます。</dd>
 <dt>{{domxref("WindowEventHandlers.onunhandledrejection")}} {{experimental_inline}}</dt>
 <dd>処理されていない {{jsxref("Promise")}} の失敗イベントを扱うためのイベントハンドラープロパティです。</dd>
 <dt>{{domxref("WindowEventHandlers.onunload")}}</dt>
 <dd>ユーザーがページから去ったときに呼び出されます。</dd>
</dl>

<h2 id="Events" name="Events">イベント</h2>

<p>これらのイベントを待ち受けするには、 {{domxref("EventTarget/addEventListener", "addEventListener()")}} を使用するか、イベントリスナーをこのインターフェイスの <code>on<em>イベント名</em></code> プロパティに代入するかしてください。</p>

<dl>
 <dt>{{domxref("Window/error_event", "error")}}</dt>
 <dd>リソースの読み込みに失敗したか、利用できないときに発生します。例えば、スクリプトに実行エラーがあった場合や、画像が見つからなかったり、向こうであったりした場合です。<br>
 {{domxref("GlobalEventHandlers/onerror", "onerror")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/languagechange_event", "languagechange")}}</dt>
 <dd>ユーザーの推奨される言語が変更されたときに、グローバルスコープオブジェクトに発生します。<br>
 {{domxref("WindowEventHandlers/onlanguagechange", "onlanguagechange")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/orientationchange_event", "orientationchange")}}</dt>
 <dd>端末の向きが変化したときに発生します。<br>
 {{domxref("Window/onorientationchange", "onorientationchange")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/devicemotion_event", "devicemotion")}}</dt>
 <dd>定期的に発生し、利用できる場合は、端末にかかっている物理的な加速度の量と傾きを示します。</dd>
 <dt>{{domxref("Window/deviceorientation_event", "deviceorientation")}}</dt>
 <dd>現在の端末の向きを地球の座標軸と比較する時期包囲センサーから新しいデータが利用できるようになったときに発生します。</dd>
 <dt><code>{{domxref("Document/defaultView/resize_event", "resize")}}</code></dt>
 <dd>Fired when the window has been resized.<br>
 {{domxref("GlobalEventHandlers/onresize", "onresize")}} プロパティからも利用できます。</dd>
 <dt><code>{{domxref("Document/defaultView/storage_event", "storage")}}</code></dt>
 <dd>ストレージ領域 (<code>localStorage</code> または <code>sessionStorage</code>) が他の文書のコンテキストから変更されたときに発生します。<br>
 {{domxref("WindowEventHandlers/onstorage", "onstorage")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="Animation_events" name="Animation_events">アニメーションイベント</h3>

<dl>
 <dt>{{domxref("Window/animationcancel_event", "animationcancel")}}</dt>
 <dd>アニメーションが予期せず中断されたときに発生します。<br>
 {{domxref("GlobalEventHandlers/onanimationcancel", "onanimationcancel")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/animationend_event", "animationend")}}</dt>
 <dd>アニメーションが正常に終了したときに発生します。<br>
 {{domxref("GlobalEventHandlers/onanimationend", "onanimationend")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/animationiteration_event", "animationiteration")}}</dt>
 <dd>アニメーションが一巡したときに発生します。<br>
 {{domxref("GlobalEventHandlers/onanimationiteration", "onanimationiteration")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/animationstart_event", "animationstart")}}</dt>
 <dd>アニメーションが開始されたときに発生します。<br>
 {{domxref("GlobalEventHandlers/onanimationstart", "onanimationstart")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="Clipboard_events" name="Clipboard_events">クリップボードイベント</h3>

<dl>
 <dt>{{domxref("Window/clipboardchange_event", "clipboardchange")}}</dt>
 <dd>システムクリップボードの内容が変化したときに発生します。</dd>
 <dt>{{domxref("Window/copy_event", "copy")}}</dt>
 <dd>ブラウザーのユーザーインターフェイスからユーザーがコピー操作を行ったときに発生します。<br>
 {{domxref("HTMLElement/oncopy", "oncopy")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/cut_event", "cut")}}</dt>
 <dd>ブラウザーのユーザーインターフェイスからユーザーが切り取り操作を行ったときに発生します。<br>
 {{domxref("HTMLElement/oncut", "oncut")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/paste_event", "paste")}}</dt>
 <dd>ブラウザーのユーザーインターフェイスからユーザーが貼り付け操作を行ったときに発生します。<br>
 {{domxref("HTMLElement/onpaste", "onpaste")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="Connection_events" name="Connection_events">接続イベント</h3>

<dl>
 <dt>{{domxref("Window/offline_event", "offline")}}</dt>
 <dd>ブラウザーがネットワークへのアクセスから切断され、 <code>navigator.onLine</code> の値が <code>false</code> に変わったときに発生します。<br>
 {{domxref("WindowEventHandlers.onoffline", "onoffline")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/online_event", "online ")}}</dt>
 <dd>ブラウザーがネットワークへのアクセスに接続され、 <code>navigator.onLine</code> の値が <code>true</code> に変わったときに発生します。<br>
 {{domxref("WindowEventHandlers.ononline", "ononline")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="Focus_events" name="Focus_events">フォーカスイベント</h3>

<dl>
 <dt>{{domxref("Window/blur_event", "blur")}}</dt>
 <dd>要素がフォーカスを失ったときに発生します。<br>
 {{domxref("GlobalEventHandlers/onblur", "onblur")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/focus_event", "focus")}}</dt>
 <dd>要素がフォーカスを得たときに発生します。<br>
 {{domxref("GlobalEventHandlers/onfocus", "onfocus")}} プロパティからも利用できます。/dd&gt;</dd>
</dl>

<h3 id="Gamepad_events" name="Gamepad_events">ゲームパッドイベント</h3>

<dl>
 <dt>{{domxref("Window/gamepadconnected_event", "gamepadconnected")}}</dt>
 <dd>ゲームパッドが接続された、またはゲームパッドのボタンや軸が初めて使用されたことをブラウザーが検出したときに発生します。<br>
 {{domxref("Window/ongamepadconnected", "ongamepadconnected")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/gamepaddisconnected_event", "gamepaddisconnected")}}</dt>
 <dd>ゲームパッドが切断されたことをブラウザーが検出したときに発生します。<br>
 {{domxref("Window/ongamepaddisconnected", "ongamepaddisconnected")}} プロパティからも利用できます。/dd&gt;</dd>
</dl>

<h3 id="History_events" name="History_events">履歴イベント</h3>

<dl>
 <dt>{{domxref("Window/hashchange_event", "hashchange")}}</dt>
 <dd>URL のフラグメント識別子 (URL の中で <code>#</code> 記号で始まり、それに続く部分) が変化したときに発生します。<br>
 {{domxref("WindowEventHandlers/onhashchange", "onhashchange")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/pagehide_event", "pagehide")}}</dt>
 <dd>ブラウザーが現在の文書を非表示にして、その場所にセッションの履歴とは異なる文書を表示するよう切り替えているときに送信されます。これはたとえば、ユーザーが「戻る」ボタンをクリックしたとき、または「進む」ボタンをクリックしてセッション履歴を先に進めたときに発生します。<br>
 <code><a href="/ja/docs/Mozilla/Tech/XUL/Attribute/onpagehide">onpagehide</a></code> イベントハンドラープロパティからも利用できます。</dd>
 <dt>{{domxref("Window/pageshow_event", "pageshow")}}</dt>
 <dd>ページが最初に読み込まれたときだけでなく、ユーザーが同じタブ内で別のページに移動した後にページに戻ったときなど、ナビゲーションタスクのためにブラウザーが文書を表示するときに送信されます。<br>
 <code><a href="/ja/docs/Mozilla/Tech/XUL/Attribute/onpageshow">onpageshow</a></code> イベントハンドラープロパティからも利用できます。</dd>
 <dt><code>{{domxref("Document/defaultView/popstate_event", "popstate")}}</code></dt>
 <dd>アクティブな履歴項目が変化したときに発生します。<br>
 {{domxref("WindowEventHandlers/onpopstate", "onpopstate")}} イベントハンドラープロパティからも利用できます。</dd>
</dl>

<h3 id="ロード・アンロードイベント">ロード・アンロードイベント</h3>

<dl>
 <dt>{{domxref("Window/beforeunload_event", "beforeunload")}}</dt>
 <dd>ウィンドウ、文書、そのリソースがアンロードされるときに発生します。<br>
 {{domxref("WindowEventHandlers/onbeforeunload", "onbeforeunload")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/DOMContentLoaded_event", "DOMContentLoaded")}}</dt>
 <dd>文書が完全に読み込まれて解析されたときに、スタイルシート、画像、サブフレームの読み込みが完了するのを待たずに発生します。</dd>
 <dt>{{domxref("Window/load_event", "load")}}</dt>
 <dd>スタイルシートや画像などの依存するすべてのリソースを含め、ページ全体の読み込みが完了したときに発生します。<br>
 {{domxref("GlobalEventHandlers/onload", "onload")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/unload_event", "unload")}}</dt>
 <dd>文書や子リソースがアンロードされるときに発生します。<br>
 {{domxref("WindowEventHandlers/onunload", "onunload")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="Manifest_events" name="Manifest_events">マニフェストイベント</h3>

<dl>
 <dt>{{domxref("Window/appinstalled_event", "appinstalled")}}</dt>
 <dd>ブラウザーがページをアプリケーションとしてインストールすることに成功したときに発生します。<br>
 {{domxref("Window/onappinstalled", "onappinstalled")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/beforeinstallprompt_event", "beforeinstallprompt")}}</dt>
 <dd>ウェブアプリケーションをインストールすることをユーザーに問い合わせようとするときに発生します。<br>
 {{domxref("Window/onbeforeinstallprompt", "onbeforeinstallprompt")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="Messaging_events" name="Messaging_events">メッセージイベント</h3>

<dl>
 <dt>{{domxref("Window/message_event", "message")}}</dt>
 <dd>ウィンドウがメッセージを受け取ったとき、例えば他のブラウザーのコンテキストから {{domxref("Window/postMessage", "Window.postMessage()")}} が呼び出された時に発生します。<br>
 {{domxref("WindowEventHandlers/onmessage", "onmessage")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/messageerror_event", "messageerror")}}</dt>
 <dd><code>Window</code> オブジェクトが復元できないメッセージを受信したときに発生します。<br>
 {{domxref("WindowEventHandlers/onmessageerror", "onmessageerror")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="Print_events" name="Print_events">印刷イベント</h3>

<dl>
 <dt>{{domxref("Window/afterprint_event", "afterprint")}}</dt>
 <dd>関連づけられた文書の印刷が始まったか、印刷プレビューが閉じた後に発生します。<br>
 {{domxref("WindowEventHandlers/onafterprint", "onafterprint")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/beforeprint_event", "beforeprint")}}</dt>
 <dd>関連づけられた文書の印刷が始まるか、印刷プレビューが表示されるときに発生します。<br>
 {{domxref("WindowEventHandlers/onbeforeprint", "onbeforeprint")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="Promise_rejection_events" name="Promise_rejection_events">Promise 拒否イベント</h3>

<dl>
 <dt>{{domxref("Window/rejectionhandled_event", "rejectionhandled")}}</dt>
 <dd>拒否を処理するハンドラーがあるかどうかにかかわらず、 JavaScript の {{jsxref("Promise")}} が拒否されるたびに送られます。<br>
 {{domxref("WindowEventHandlers/onrejectionhandled", "onrejectionhandled")}} イベントハンドラープロパティからも利用できます。</dd>
 <dt>{{domxref("Window/unhandledrejection_event", "unhandledrejection")}}</dt>
 <dd>JavaScript の {{jsxref("Promise")}} が拒否されたものの、拒否を処理するハンドラーがないときに送られます。<br>
 {{domxref("WindowEventHandlers/onunhandledrejection", "onunhandledrejection")}} イベントハンドラープロパティからも利用できます。</dd>
</dl>

<h3 id="Transition_events" name="Transition_events">トランジションイベント</h3>

<dl>
 <dt>{{domxref("Window/transitioncancel_event", "transitioncancel")}}</dt>
 <dd><a href="/ja/docs/CSS/Using_CSS_transitions">CSS トランジション</a>が中止されたときに発生します。<br>
 {{domxref("GlobalEventHandlers/ontransitioncancel", "ontransitioncancel")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/transitionend_event", "transitionend")}}</dt>
 <dd><a href="/ja/docs/CSS/Using_CSS_transitions">CSS トランジション</a>が完了したときに発生します。<br>
 {{domxref("GlobalEventHandlers/ontransitionend", "ontransitionend")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/transitionrun_event", "transitionrun")}}</dt>
 <dd><a href="/ja/docs/CSS/Using_CSS_transitions">CSS トランジション</a>が初めて作成されたときに発生します。<br>
 {{domxref("GlobalEventHandlers/ontransitionrun", "ontransitionrun")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/transitionstart_event", "transitionstart")}}</dt>
 <dd><a href="/ja/docs/CSS/Using_CSS_transitions">CSS トランジション</a>が実際に開始されたときに発生します。<br>
 {{domxref("GlobalEventHandlers/ontransitionstart", "ontransitionstart")}} プロパティからも利用できます。</dd>
</dl>

<h3 id="WebVR_events" name="WebVR_events">WebVR イベント</h3>

<dl>
 <dt>{{domxref("Window/vrdisplayactivate_event", "vrdisplayactivate")}}</dt>
 <dd>VR ディスプレイが表示する準備ができたとき、例えば HMD がスタンバイ状態に移行したり、装着して準備ができたときに発生します。<br>
 {{domxref("Window/onvrdisplayactivate", "onvrdisplayactivate")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/vrdisplayblur_event", "vrdisplayblur")}}</dt>
 <dd>ブラウザー、 OS、 VR ハードウェアの何れかが原因で、 VR ディスプレイの表示が停止したときに発生します。<br>
 {{domxref("Window/onvrdisplayblur", "onvrdisplayblur")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/vrdisplayconnect_event", "vrdisplayconnect")}}</dt>
 <dd>互換性のある VR ディスプレイがコンピューターに接続されたときに発生します。<br>
 {{domxref("Window/onvrdisplayconnect", "onvrdisplayconnect")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/vrdisplaydeactivate_event", "vrdisplaydeactivate")}}</dt>
 <dd>VR ディスプレイが表示をやめる可能性があるとき、例えば HMD が一定時間使用されなかったためにスタンバイまたはスリープモードに入ったときなどに発生します。<br>
 {{domxref("Window/onvrdisplaydeactivate", "onvrdisplaydeactivate")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/vrdisplaydisconnect_event", "vrdisplaydisconnect")}}</dt>
 <dd>互換性のある VR ディスプレイがコンピュータから切り離されたときに発生します。<br>
 {{domxref("Window/onvrdisplaydisconnect", "onvrdisplaydisconnect")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/vrdisplayfocus_event", "vrdisplayfocus")}}</dt>
 <dd>VR ディスプレイへの表示を休んだ後で復帰したときに発生します。<br>
 {{domxref("Window/onvrdisplayfocus", "onvrdisplayfocus")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/vrdisplaypresentchange_event", "vrdisplaypresentchange")}}</dt>
 <dd>VR ディスプレイの表示状態が変化したときに発生します。 — すなわち、表示を始めたり、表示を消したり、などです。<br>
 {{domxref("Window/onvrdisplaypresentchange", "onvrdisplaypresentchange")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/vrdisplaypointerrestricted_event", "vrdisplaypointerrestricted")}}</dt>
 <dd>VR ディスプレイのポインター入力の消費が <a href="/ja/docs/Web/API/Pointer_Lock_API">pointerlocked 要素</a>によって抑止されたときに発生します。<br>
 {{domxref("Window/onvrdisplaypointerrestricted", "onvrdisplaypointerrestricted")}} プロパティからも利用できます。</dd>
 <dt>{{domxref("Window/vrdisplaypointerunrestricted_event", "vrdisplaypointerunrestricted")}}</dt>
 <dd>VR ディスプレイのポインター入力の消費が <a href="/ja/docs/Web/API/Pointer_Lock_API">pointerlocked 要素</a>によって抑止が解除されたときに発生します。<br>
 {{domxref("Window/onvrdisplaypointerunrestricted", "onvrdisplaypointerunrestricted")}} プロパティからも利用できます。</dd>
</dl>

<h2 id="Interfaces" name="Interfaces">インターフェイス</h2>

<p><a href="/ja/docs/DOM/DOM_Reference" title="DOM/DOM_Reference">DOM リファレンス</a> をご覧ください。</p>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>

<p>{{Compat("api.Window")}}</p>