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.directories
window.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.onafterprint
afterprint
イベントが発生したときに呼び出すコードを表すEventHandler
です。WindowEventHandlers.onbeforeprint
beforeprint
イベントが発生したときに呼び出すコードを表す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.ondeviceorientationabsolute
Chrome 限定- デバイスの向きが変化したイベントのイベントハンドラプロパティです。
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.onmessage
message
イベントが発生したときに呼び出すコードを表すEventHandler
です。GlobalEventHandlers.onmousedown
- window 上でのマウスダウン時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onmousemove
- window 上でのマウス移動時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onmouseout
- window のマウスアウト時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onmouseover
- window のマウスオーバー時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onmouseup
- window のマウスアップ時に発生するイベントのイベントハンドラ
Window.onmozbeforepaint
MozBeforePaint
イベントのイベントハンドラプロパティです。Window.mozRequestAnimationFrame()
メソッドの呼び出しによってイベントが要求された場合に、window を再描画する前に送信されます。WindowEventHandlers.onoffline
offline
イベントが発生したときに呼び出すコードを表すEventHandler
です。WindowEventHandlers.ononline
online
イベントが発生したときに呼び出すコードを表すEventHandler
です。WindowEventHandlers.onpagehide
pagehide
イベントが発生したときに呼び出すコードを表すEventHandler
です。WindowEventHandlers.onpageshow
pageshow
イベントが発生したときに呼び出すコードを表すEventHandler
です。Window.onpaint
- window の描画時に発生するイベントのイベントハンドラ
WindowEventHandlers.onpopstate
- popstate イベントのイベントハンドラプロパティです。状態オブジェクトを表すセッション履歴エントリを移動するときに、このイベントが発生します。
Window.onrejectionhandled
Promise
の失敗イベントを扱うためのイベントハンドラプロパティです。GlobalEventHandlers.onreset
- window の reset イベントのイベントハンドラプロパティです。
GlobalEventHandlers.onresize
- window のリサイズ時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onscroll
- window のスクロール時に発生するイベントのイベントハンドラ
GlobalEventHandlers.onselect
- window を選択したときに発生するイベントのイベントハンドラプロパティです。
GlobalEventHandlers.onselectionchange
selectionchange
イベントが発生したときに呼び出すコードを表すEventHandler
です。WindowEventHandlers.onstorage
storage
イベントが発生したときに実行するイベントハンドラです。- これはストレージ領域が変化したとき (例えば新たなアイテムを保存したとき) に発生します。
GlobalEventHandlers.onsubmit
- window のフォームを送信したときに発生するイベントのイベントハンドラプロパティです。
WindowEventHandlers.onunhandledrejection
- 処理されていない
Promise
の失敗イベントを扱うためのイベントハンドラプロパティです。 WindowEventHandlers.onunload
- window のアンロード時に発生するイベントのイベントハンドラ
Window.onuserproximity
- User Proximity イベントのイベントハンドラプロパティです。
コンストラクタ
DOM インターフェイスもご覧ください。
Window.DOMParser
- FIXME: NeedsContents
Window.GeckoActiveXObject
- FIXME: NeedsContents
Image
HTMLImageElement
を生成します。Option
HTMLOptionElement
を生成します。Window.QueryInterface
- FIXME: NeedsContents
Window.XMLSerializer
- FIXME: NeedsContents
Worker
- Web worker を生成します。
Window.XPCNativeWrapper
- FIXME: NeedsContents
Window.XPCSafeJSObjectWrapper
- FIXME: NeedsContents