window オブジェクトは、DOM document を収めるウィンドウを表します。document プロパティは、そのウィンドウに読み込まれた DOM の document オブジェクトを指します。特定のドキュメントが属するウィンドウは、document.defaultView プロパティを使用して取得できます。

このセクションでは、DOM の window オブジェクトで使用できるメソッド、プロパティ、イベントのすべてについての簡潔なリファレンスを提供します。window オブジェクトは Window インターフェイスを実装しており、Window インターフェイスは AbstractView インターフェイスを継承しています。一般的には window に関連づけられていませんが window で使用可能なグローバル関数、名前空間、オブジェクト、インターフェイス、コンストラクタは JavaScript リファレンス および DOM リファレンスに掲載しています。

Firefox のようなタブブラウザでは、タブの各々が、それ自身の window オブジェクトを持っています (※拡張機能を記述している場合、ブラウザウィンドウ自身も別個のウィンドウです - 詳しい情報は、chrome コードでウィンドウを取り扱う を参照してください)。つまり window オブジェクトは、同じウィンドウのタブ間で共有されません。window.resizeTowindow.resizeBy のようないくつかの一部のメソッドは、ウィンドウ全体に適用され、その window オブジェクトが属する特定のタブには適用されません。一般的に、タブに属することができないもっともな理由があるものは、代わりにウィンドウに属します。

プロパティ

このインターフェイスは、EventTarget インターフェイスからプロパティを継承します。また WindowTimersWindowBase64WindowEventHandlers のプロパティを実装します。

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

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 ピクセルで表します。必要に応じてスクリーンピクセルに換算するための係数については、nsIDOMWindowUtilsmozScreenPixelsPerCSSPixel をご覧ください。
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 インターフェイスからメソッドを継承します。また WindowTimersWindowBase64WindowEventHandlersGlobalFetch のメソッドを実装します。

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 インターフェイスからイベントハンドラを継承します。また WindowTimersWindowBase64WindowEventHandlers のイベントハンドラを実装します。

注記: 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

インターフェイス

DOM リファレンス をご覧ください。

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: yyss, khalid32, ethertank, Crash, Potappo, Shoot, Norah, Mgjbot, Okome, Hfjapancom
 最終更新者: yyss,