検索結果

window

この記事内

プロパティ
メソッド
イベントハンドラ
コンストラクタ
インターフェイス
関連情報

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

インターフェイス

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

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

タグ:

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

最終更新者: yyss, 2016/04/26 8:27:18