window オブジェクトは、DOM document を収めるウィンドウを表します。document プロパティは、そのウィンドウに読み込まれた DOM の document オブジェクトを指します。特定のドキュメントが属するウィンドウは、document.defaultView プロパティを使用して取得できます。
このセクションでは、DOM の window オブジェクトで使用できるメソッド、プロパティ、イベントのすべてについての簡潔なリファレンスを提供します。window オブジェクトは Window インターフェイスを実装しており、Window インターフェイスは AbstractView インターフェイスを継承しています。一般的には window に関連づけられていませんが window で使用可能なグローバル関数、名前空間、オブジェクト、インターフェイス、コンストラクタは JavaScript リファレンス および DOM リファレンスに掲載しています。
Firefox のようなタブブラウザでは、タブの各々が、それ自身の window オブジェクトを持っています (※拡張機能を記述している場合、ブラウザウィンドウ自身も別個のウィンドウです - 詳しい情報は、chrome コードでウィンドウを取り扱う を参照してください)。つまり window オブジェクトは、同じウィンドウのタブ間で共有されません。window.resizeTo と window.resizeBy のようないくつかの一部のメソッドは、ウィンドウ全体に適用され、その window オブジェクトが属する特定のタブには適用されません。一般的に、タブに属することができないもっともな理由があるものは、代わりにウィンドウに属します。
プロパティ
このインターフェイスは、EventTarget インターフェイスからプロパティを継承します。また WindowTimers、WindowBase64、WindowEventHandlers のプロパティを実装します。
オブジェクトであるプロパティ (例えば、ビルトイン要素のプロトタイプをオーバーライドするためのもの) は、後述の個別セクションに記載しています。
Window.applicationCache読取専用- ウィンドウのオフラインリソースへのアクセス手段を提供する
OfflineResourceListオブジェクト Window.caches読取専用- 現在のオリジンに関連づけられている
CacheStorageオブジェクトを返します。このオブジェクトはオフラインで使用する資源の保存、あるいはリクエストに対して独自のレスポンスを生成するといった、Service Worker の機能を実現します。 Window.closed読取専用- カレントウィンドウが閉じているかどうかを示す
Window.Components- 多くの XPCOM 機能へのエントリポイント。いくつかのプロパティ、例えば classes などは、必要な特権が与えられたコードでのみ動作します。Web 上のコードでこのプロパティを使用しないでください。
Window.console読取専用- ブラウザのデバッグコンソールへのアクセス手段を提供する、console オブジェクトへの参照を返します。
Window.contentおよび Window._content 読取専用- カレントウィンドウでのコンテンツ要素への参照を返す（※アンダースコア付きの変種は廃止されており、Web コンテンツでは使用できません）
Window.controllers読取専用- カレント chrome ウィンドウの XUL controller オブジェクトを返す
Window.crypto読取専用- ブラウザの crypto オブジェクトを返す
Window.defaultStatus廃止 Gecko 23- 指定ウィンドウのステータスバーのテキストを取得 / 設定
Window.devicePixelRatio読取専用- カレントディスプレイの、物理ピクセルとデバイス固有のピクセルの比率を返します。
Window.dialogArguments読取専用window.showModalDialog()メソッドが呼び出されたときにウィンドウ（それがダイアログボックスである場合）に渡された引数を取得。これはnsIArrayインタフェースです。Window.directorieswindow.personalbarと同義Window.document読取専用- 指定ウィンドウが含む文書への参照を返す
Window.frameElement読取専用- ウィンドウが埋め込まれた要素を返す。ウィンドウが埋め込まれていない場合は、null を返す。
Window.frames読取専用- 現在のウィンドウでのサブフレームの配列を返す
Window.fullScreen- ウィンドウがフルスクリーン表示状態であるかどうかを表す真偽値を返す
Window.globalStorage廃止 Gecko 13- Gecko 13 (Firefox 13) 以降ではサポートされていません。
Window.localStorageを代わりに用います。
複数のページに渡ってデータを保存するために使用する、複数のストレージオブジェクトを表していました。 Window.history読取専用- history オブジェクトへの参照を返す
Window.innerHeight- ブラウザウィンドウの、スクロール領域を含むコンテンツ領域の高さを取得
Window.innerWidth- ブラウザウィンドウの、スクロール領域を含むコンテンツ領域の幅を取得
Window.isSecureContext読取専用- 安全なコンテキストを必要とする機能を使用できる状況であるかを表します。
Window.length読取専用- ウィンドウ内のフレームの数を返す (※参照
window.frames) Window.location読取専用- window オブジェクトのロケーション、または現在の URL を取得 / 設定
Window.locationbar読取専用- ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な locationbar オブジェクトを返す
Window.localStorage読取専用- 生成元のオリジンからのみアクセスが可能なデータを保存するために使用する、ローカルストレージオブジェクトへの参照を返します。
Window.menubar読取専用- ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な menubar オブジェクトを返す
Window.messageManager- 当該 window の message manager オブジェクトを返します。
Window.mozAnimationStartTime読取専用- 現在のアニメーションサイクルが開始したときから経過した時間をミリ秒単位で表します。
Window.mozInnerScreenX読取専用- スクリーン座標系で、window のビューポートの左上隅の水平 (X) 座標を返します。この値は CSS ピクセルで表します。必要に応じてスクリーンピクセルに換算するための係数については、
nsIDOMWindowUtilsのmozScreenPixelsPerCSSPixelをご覧ください。 Window.mozInnerScreenY読取専用- スクリーン座標系で、window のビューポートの左上隅の垂直 (Y) 座標を返します。この値は CSS ピクセルで表します。必要に応じてスクリーンピクセルに換算するための係数については、
mozScreenPixelsPerCSSPixelをご覧ください。 Window.mozPaintCount読取専用- 当該ウィンドウで、カレントドキュメントをスクリーンに描画した回数を返します。これは、描画パフォーマンスの算定に使用できます。
Window.name- ウィンドウ名を取得 / 設定
Window.navigator読取専用- navigator オブジェクトへの参照を返す
Window.opener- 現在のウィンドウを開いたウィンドウへの参照を返す
Window.orientation読取専用- デバイスの本来の向きに対する、ビューポートの向きを角度 (90 度単位) で返します。
Window.outerHeight読取専用- ブラウザウィンドウの外側の高さを取得
Window.outerWidth読取専用- ブラウザウィンドウの外側の幅を取得
Window.pageXOffset読取専用window.scrollXのエイリアスWindow.pageYOffset読取専用window.scrollYのエイリアスWindow.sessionStorage読取専用- 生成元のオリジンからのみアクセスが可能なデータを保存するために使用する、セッションストレージへの参照を返します。
Window.parent読取専用- カレントウィンドウまたはサブフレームの親ウィンドウへの参照を返す
Window.performance読取専用- パフォーマンス関連属性を収容する領域を提供します。
Window.personalbar読取専用- ウィンドウ内で表示/非表示の切り替え (トグル) が可能な、 personalbar オブジェクトを返す
Window.pkcs11廃止 Gecko 29- PKCS11 モジュールのインストールや削除を行う機能を提供していました。
Window.returnValue- ウィンドウをモーダルダイアログとして表示する
window.showModalDialog()メソッドを呼び出した関数へ返却される戻り値 Window.screen読取専用- ウィンドウに関連付けられた screen オブジェクトへの参照を返す
Window.screenX読取専用- 画面の左端からユーザのブラウザの左端までの水平方向の距離を返す
Window.screenY読取専用- 画面の上端からユーザのブラウザの上端までの垂直方向の距離を返す
Window.scrollbars読取専用- ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な、scrollbars オブジェクトを返す
Window.scrollMaxX読取専用- ウィンドウが水平スクロールされ得る最大オフセット (※即ち、ビューポートの幅を引いた文書の幅)
Window.scrollMaxY読取専用- ウィンドウが垂直スクロールされ得る最大オフセット (すなわち、ビューポートの高さを除いた文書の高さ)
Window.scrollX読取専用- 水平スクロールされているピクセル数を返す
Window.scrollY読取専用- 垂直スクロールされているピクセル数を返す
Window.self読取専用- window オブジェクト自身へのオブジェクト参照を返す
Window.sessionStorage- 単一のページセッション内のデータを保存するためのストレージオブジェクトを返します。
Window.sidebar読取専用- サイドバーの window オブジェクトへの参照を返す
Window.speechSynthesis読取専用SpeechSynthesisオブジェクトを返します。これは、Web Speech API の音声合成機能を使用するためのエントリポイントです。Window.status- ブラウザ下部のステータスバーのテキストを取得 / 設定
Window.statusbar読取専用- ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な、statusbar オブジェクトを返す
Window.toolbar読取専用- ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な、toolbar オブジェクトを返す
Window.top読取専用- ウィンドウ階層における最上位のウィンドウへの参照を返します。このプロパティは読み取り専用です。
Window.window読取専用- 現在のウィンドウへの参照を返す
window[0]、window[1]など- フレーム内の
windowオブジェクトへの参照を返します。詳しくはWindow.framesをご覧ください。
メソッド
このインターフェイスは、EventTarget インターフェイスからメソッドを継承します。また WindowTimers、WindowBase64、WindowEventHandlers、GlobalFetch のメソッドを実装します。
EventTarget.addEventListener()- window 内の特定のイベントタイプに、イベントハンドラを登録します。
Window.alert()- 警告ダイアログを表示
WindowBase64.atob()- Base64 エンコーディングを使用してエンコードされたデータ文字列をデコードします。
Window.back()- window の履歴をひとつ戻ります。
Window.blur()- window からフォーカスを外します。
WindowBase64.btoa()- バイナリデータを Base64 でエンコードした ASCII 文字列を生成します。
Window.cancelIdleCallback()Window.requestIdleCallbackによって過去にスケジューリングされたコールバックをキャンセルできます。Window.captureEvents()- 特定のタイプのイベントをすべてキャプチャするよう、window に登録します。
Window.clearImmediate()setImmediateで設定した繰り返し処理をキャンセルします。WindowTimers.clearInterval()WindowTimers.setInterval()で繰り返し実行されるよう設定された命令をキャンセルWindowTimers.clearTimeout()WindowTimers.setTimeout()で設定した繰り返し処理をキャンセルします。Window.close()- カレントウィンドウを閉じます。
Window.confirm()- ユーザの応答が必要なメッセージを持つダイアログを表示します。
Window.disableExternalCapture()廃止 Gecko 24- FIXME: NeedsContents
Window.dispatchEvent()- イベントを発生させるために使用します。
Window.dump()- コンソールにメッセージを出力
Window.enableExternalCapture()廃止 Gecko 24- FIXME: NeedsContents
GlobalFetch.fetch()- リソースを取り込む処理を開始します。
Window.find()- ウィンドウ内で文字列を検索します。
Window.focus()- カレントウィンドウにフォーカスを当てます。
Window.forward()- 履歴でひとつ先のドキュメントに移動します。
Window.getAttention()- アプリケーションアイコンをフラッシュさせます。
Window.getAttentionWithCycleCount()- FIXME: NeedsContents
Window.getComputedStyle()- 特定の要素の計算済みスタイルを取得します。計算済みスタイルは、要素のすべての CSS プロパティの計算値を示します。
Window.getDefaultComputedStyle()- 特定の要素について、作者のスタイルシートを無視したデフォルトの計算済みスタイルを取得します。
Window.getSelection()- 選択されたアイテムを表す、セレクションオブジェクトを返します。
Window.home()- ブラウザのホームページに戻ります。
Window.matchMedia()- 指定したメディアクエリ文字列を表す
MediaQueryListオブジェクトを返します。 Window.maximize()- FIXME: NeedsContents
Window.minimize()(トップレベルの XUL ウィンドウに限る)- ウィンドウを最小化します。
Window.moveBy()- カレントウィンドウを指定した距離移動します。
Window.moveTo()- ウィンドウを指定した位置に移動します。
Window.mozRequestAnimationFrame()- アニメーションが進行中であることをブラウザに伝えて、次のアニメーションフレームのためにウィンドウの再描画を予定するよう要求します。再描画を実行する前に
MozBeforePaintイベントが発生します。 Window.open()- 新しいウィンドウを開く
Window.openDialog()- 新しいダイアログウィンドウを開く
Window.postMessage()- あるウィンドウから別のウィンドウへ、安全にデータ文字列を送信する手段を提供します。送信先ウィンドウは、送信元と同じドメインでなくてもかまいません。
Window.print()- カレントドキュメントを印刷するためのダイアログを開きます。
Window.prompt()- ユーザが入力ダイアログに入力したテキストを返します。
Window.releaseEvents()- 特定のタイプのイベントのキャプチャを解放します。
Window.removeEventListener()- window からイベントリスナを削除します。
Window.requestIdleCallback()- ブラウザがアイドル状態であるときに実行するタスクをスケジューリングします。
Window.resizeBy()- カレントウィンドウを、指定した大きさの分だけ変更します。
Window.resizeTo()- ウィンドウを動的にリサイズします。
Window.restore()- FIXME: NeedsContents
Window.routeEvent()廃止 Gecko 24- FIXME: NeedsContents
Window.scroll()- ドキュメント内の特定の位置に、ウィンドウをスクロールします。
Window.scrollBy()- ウィンドウ内のドキュメントを、指定した距離の分だけスクロールします。
Window.scrollByLines()- ドキュメントを指定した行数分、スクロールします。
Window.scrollByPages()- ドキュメントを指定したページ数分、スクロールします。
Window.scrollTo()- ドキュメント内の特定の位置に、ウィンドウをスクロールします。
Window.setCursor()- カレントウィンドウのカーソルを変更します。
Window.setImmediate()- ブラウザで他の高負荷なタスクが完了した後に、関数を実行します。
WindowTimers.setInterval()- 特定の時間 (ミリ秒単位) が経過するたびに関数を実行するようスケジューリングします。
Window.setResizable- FIXME: NeedsContents
WindowTimers.setTimeout()- 関数を実行するまでの遅延時間を設定します。
Window.showModalDialog()- モーダルダイアログを表示
Window.sizeToContent()- コンテンツに応じてウィンドウのサイズを調整します。
Window.stop()- ウィンドウの読み込み処理を停止します。
Window.updateCommands()- カレント chrome ウィンドウ (UI) のコマンドの状態を更新します。
イベントハンドラ
これらは window で発生する、関心を持つと思われるさまざまな状況に対してイベントハンドラを設定することができる、window オブジェクトのプロパティです。
このインターフェイスは、EventTarget インターフェイスからイベントハンドラを継承します。また WindowTimers、WindowBase64、WindowEventHandlers のイベントハンドラを実装します。
注記: Gecko 9.0 より、あるイベントハンドラプロパティが存在するかを調べるために if ("onabort" in window) という構文を使用できます。これは、web IDL インターフェイスを適正にするためにイベントハンドラインターフェイスが更新されるためです。詳しくは DOM event handlers をご覧ください。
GlobalEventHandlers.onabort- window でイベントが異常終了した際のイベントハンドラプロパティです。
WindowEventHandlers.onafterprintafterprintイベントが発生したときに呼び出すコードを表すEventHandlerです。WindowEventHandlers.onbeforeprintbeforeprintイベントが発生したときに呼び出すコードを表すEventHandlerです。Window.onbeforeinstallprompt- モバイル環境 で web サイトをホームスクリーンに保存させる前に発生するイベントハンドラプロパティです。
WindowEventHandlers.onbeforeunload- window でイベントをアンロードする前のイベントハンドラプロパティです。
GlobalEventHandlers.onblur- window の blur イベントのイベントハンドラプロパティです。
GlobalEventHandlers.onchange- window の change イベントのイベントハンドラプロパティです。
GlobalEventHandlers.onclick- window の click イベントのイベントハンドラプロパティです。
GlobalEventHandlers.onclose- window の close イベントを扱うためのイベントハンドラプロパティです。
GlobalEventHandlers.oncontextmenu- window の右クリックイベントのイベントハンドラプロパティです。
Window.ondevicelight- 環境光のレベルが変化したイベントのイベントハンドラプロパティです。
Window.ondevicemotion- FIXME: NeedsContents
Window.ondeviceorientation- デバイスの相対的な向きが変化したイベントのイベントハンドラプロパティです。
Window.ondeviceorientationabsoluteChrome 限定- デバイスの向きが変化したイベントのイベントハンドラプロパティです。
Window.ondeviceproximity- デバイスの proximity イベントのイベントハンドラプロパティです。
GlobalEventHandlers.onerror- window の
errorイベントのイベントハンドラプロパティです。 GlobalEventHandlers.onfocus- window の
focusイベントのイベントハンドラプロパティです。 WindowEventHandlers.onhashchange- window のハッシュ変更イベントのイベントハンドラプロパティです。URL のハッシュ記号 ("#") の後の部分が変化したときに呼び出されます。
GlobalEventHandlers.onkeydown- window 上での
keydownイベントのイベントハンドラ GlobalEventHandlers.onkeypress- window 上での
keypressイベントのイベントハンドラ GlobalEventHandlers.onkeyup- window 上での
keyupイベントのイベントハンドラ WindowEventHandlers.onlanguagechange- window の
languagechangeイベントのイベントハンドラプロパティです。 GlobalEventHandlers.onload- window の読み込みの完了時に発生するイベントのイベントハンドラ
WindowEventHandlers.onmessagemessageイベントが発生したときに呼び出すコードを表すEventHandlerです。GlobalEventHandlers.onmousedown- window 上でのマウスダウン時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onmousemove- window 上でのマウス移動時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onmouseout- window のマウスアウト時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onmouseover- window のマウスオーバー時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onmouseup- window のマウスアップ時に発生するイベントのイベントハンドラ
Window.onmozbeforepaintMozBeforePaintイベントのイベントハンドラプロパティです。Window.mozRequestAnimationFrame()メソッドの呼び出しによってイベントが要求された場合に、window を再描画する前に送信されます。WindowEventHandlers.onofflineofflineイベントが発生したときに呼び出すコードを表すEventHandlerです。WindowEventHandlers.ononlineonlineイベントが発生したときに呼び出すコードを表すEventHandlerです。WindowEventHandlers.onpagehidepagehideイベントが発生したときに呼び出すコードを表すEventHandlerです。WindowEventHandlers.onpageshowpageshowイベントが発生したときに呼び出すコードを表すEventHandlerです。Window.onpaint- window の描画時に発生するイベントのイベントハンドラ
WindowEventHandlers.onpopstate- popstate イベントのイベントハンドラプロパティです。状態オブジェクトを表すセッション履歴エントリを移動するときに、このイベントが発生します。
Window.onrejectionhandledPromiseの失敗イベントを扱うためのイベントハンドラプロパティです。GlobalEventHandlers.onreset- window の reset イベントのイベントハンドラプロパティです。
GlobalEventHandlers.onresize- window のリサイズ時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onscroll- window のスクロール時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onselect- window を選択したときに発生するイベントのイベントハンドラプロパティです。
GlobalEventHandlers.onselectionchangeselectionchangeイベントが発生したときに呼び出すコードを表すEventHandlerです。WindowEventHandlers.onstoragestorageイベントが発生したときに実行するイベントハンドラです。- これはストレージ領域が変化したとき (例えば新たなアイテムを保存したとき) に発生します。
GlobalEventHandlers.onsubmit- window のフォームを送信したときに発生するイベントのイベントハンドラプロパティです。
WindowEventHandlers.onunhandledrejection- 処理されていない
Promiseの失敗イベントを扱うためのイベントハンドラプロパティです。 WindowEventHandlers.onunload- window のアンロード時に発生するイベントのイベントハンドラ
Window.onuserproximity- User Proximity イベントのイベントハンドラプロパティです。
コンストラクタ
DOM インターフェイスもご覧ください。
Window.DOMParser- FIXME: NeedsContents
Window.GeckoActiveXObject- FIXME: NeedsContents
ImageHTMLImageElementを生成します。OptionHTMLOptionElementを生成します。Window.QueryInterface- FIXME: NeedsContents
Window.XMLSerializer- FIXME: NeedsContents
Worker- Web worker を生成します。
Window.XPCNativeWrapper- FIXME: NeedsContents
Window.XPCSafeJSObjectWrapper- FIXME: NeedsContents