Window
Window インターフェイスは、 DOM 文書を収めるウィンドウを表します。 document プロパティは、そのウィンドウに読み込まれた DOM の document オブジェクト を指します。
特定の文書が属するウィンドウは、 document.defaultView プロパティを使用して取得できます。
グローバル変数の window は、スクリプトを実行しているウィンドウを表しており、 JavaScript コードに公開されます。
Window インターフェイスは、ユーザーインターフェイスのウィンドウの概念とは必ずしも直接関連づかない、さまざまな関数、名前空間、オブジェクト、コンストラクターのホームです。一方、 Window インターフェイスはグローバルで使用可能であることが必要な、さまざまなアイテムを含むのに適した場所です。これらの多くは JavaScript リファレンス や DOM リファレンス で文書化しています。
タブブラウザーでは、それぞれのタブが個々の Window オブジェクトで表されます。タブ内で実行している JavaScript から見えるグローバルの window は、常にコードを実行しているタブを表します。しかし、タブブラウザーであっても resizeTo() や innerHeight のように、タブを含むウィンドウ全体に適用されるプロパティやメソッドがあります。一般に、タブに所属することができない合理的な理由があるものは、代わりにウィンドウに属します。
コンストラクター
DOM インターフェイスもご覧ください。
DOMParser-
DOMParserは文字列で保存された XML や HTML ソースを DOM Document に解釈することができます。DOMParserは DOM Parsing and Serialization で定められています。 Image(en-US)-
HTMLImageElementを生成します。 Option(en-US)-
HTMLOptionElementを生成します。 StaticRange(en-US) Experimental 読取専用-
StaticRange(en-US) オブジェクトを作成するStaticRange()(en-US) コンストラクターを返します。 Worker-
ウェブワーカーを生成します。
XMLSerializer-
DOM ツリーを XML または HTML ソースに変換します。
プロパティ
このインターフェイスは EventTarget インターフェイスからプロパティを継承しています。
オブジェクトであるプロパティ(例えば、組み込み要素のプロトタイプを上書きするためのもの)は、後述の個別セクションに記載しています。
Window.clientInformation読取専用-
Window.navigatorの別名です。 Window.closed読取専用-
このプロパティは、現在のウィンドウが閉じているかどうかを示します。
Window.console読取専用-
ブラウザーのデバッグコンソールへアクセスするための console オブジェクトへの参照を返します。
Window.customElements読取専用-
CustomElementRegistryオブジェクトへの参照を返します。これは新しいカスタム要素の登録や、以前に登録したカスタム要素の情報を取得するために使用できます。 Window.crypto読取専用-
ブラウザーの crypto オブジェクトを返します。
Window.devicePixelRatio読取専用-
現在のディスプレイの、物理ピクセルと端末非依存ピクセルの比率を返します。
Window.document読取専用-
指定ウィンドウにある文書への参照を返します。
Window.event非推奨 読取専用-
現在のイベントを返します。これは現在 JavaScript のコードのコンテキストが処理しているイベントです。また、現在処理しているイベントがない場合は
undefinedを返します。可能な限り、イベントハンドラーに直接渡したEventオブジェクトを代わりに使用してください。 Window.external(en-US) 非推奨 読取専用-
外部の検索プロバイダーをブラウザーに追加するための関数を持つオブジェクトを返します。
Window.frameElement読取専用-
ウィンドウが埋め込まれた要素を返します。ウィンドウが埋め込まれていない場合は、 null を返します。
Window.frames読取専用-
現在のウィンドウでのサブフレームの配列を返します。
Window.fullScreen-
このプロパティはウィンドウが全画面で表示されているかどうかを示します。
Window.history読取専用-
history オブジェクトへの参照を返します。
Window.innerHeight読取専用-
ブラウザーウィンドウのコンテンツ領域の高さを取得し、もしあれば、水平スクロールバーを含みます。
Window.innerWidth読取専用-
ブラウザーウィンドウのコンテンツ領域の幅を取得し、もしあれば、垂直スクロールバーを含みます。
isSecureContextExperimental 読取専用-
コンテキストが、安全なコンテキストを必要とする機能を使用することができるかどうかを表します。
Window.length読取専用-
ウィンドウ内のフレームの数を返します。
window.framesも参照してください。 Window.location-
window オブジェクトのロケーション、または現在の URL を取得 / 設定します。
Window.locationbar読取専用-
ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な locationbar オブジェクトを返します。
Window.localStorage読取専用-
生成元のオリジンからのみアクセスが可能なデータを保存するために使用する、ローカルストレージオブジェクトへの参照を返します。
-
ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な menubar オブジェクトを返します。
Window.messageManagerNon-standard-
このウィンドウの message manager オブジェクトを返します。
Window.mozInnerScreenX読取専用 Non-standard-
スクリーン座標系でウィンドウのビューポートの左上隅の水平 (X) 座標を返します。この値は CSS ピクセルで表します。必要に応じて画面のピクセルに換算するための係数については、
nsIDOMWindowUtilsのmozScreenPixelsPerCSSPixelをご覧ください。 Window.mozInnerScreenY読取専用 Non-standard-
スクリーン座標系で、ウィンドウビューポートの左上隅の垂直 (Y) 座標を返します。この値は CSS ピクセルで表します。必要に応じて画面のピクセルに換算するための係数については
mozScreenPixelsPerCSSPixelをご覧ください。 Window.name-
ウィンドウ名を取得 / 設定します。
-
navigator オブジェクトへの参照を返します。
Window.opener-
現在のウィンドウを開いたウィンドウへの参照を返します。
Window.outerHeight読取専用-
ブラウザーウィンドウの外側の高さを取得します。
Window.outerWidth読取専用-
ブラウザーウィンドウの外側の幅を取得します。
Window.pageXOffset読取専用-
window.scrollXのエイリアスです。 Window.pageYOffset読取専用-
window.scrollYのエイリアスです。 Window.parent読取専用-
現在のウィンドウまたはサブフレームの親ウィンドウへの参照を返します。
Window.performance読取専用-
Performanceオブジェクトを返します。これはtimingやnavigation属性が含まれており、それぞれが パフォーマンス関連 (en-US) のデータを提供するオブジェクトです。詳細情報や使用例はナビゲーションタイミングの使用 (en-US)をご覧ください。 Window.personalbar読取専用-
ウィンドウ内で表示/非表示の切り替え (トグル) が可能な、 personalbar オブジェクトを返す
Window.screen読取専用-
ウィンドウに関連付けられた screen オブジェクトへの参照を返す
Window.screenXおよびWindow.screenLeft(en-US) 読取専用-
どちらのプロパティも、ユーザーのブラウザーのビューポートの左端から画面の左端までの水平方向の距離を返します。
Window.screenYおよびWindow.screenTop(en-US) 読取専用-
どちらのプロパティも、ユーザーのブラウザーのビューポートの上端から画面の上端までの垂直方向の距離を返します。
Window.scrollbars読取専用-
ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な、 scrollbars オブジェクトを返す
Window.scrollMaxXNon-standard 読取専用-
ウィンドウが水平スクロールされ得る最大オフセット、すなわち、文書の幅からビューポートの幅を引いたものです。
Window.scrollMaxYNon-standard 読取専用-
ウィンドウが垂直スクロールされ得る最大オフセット (すなわち、文書の高さからビューポートの高さを引いたもの) です。
Window.scrollX読取専用-
文書が現在水平にスクロールされているピクセル数を返します。
Window.scrollY読取専用-
文書が現在垂直にスクロールされているピクセル数を返します。
Window.self読取専用-
window オブジェクト自身へのオブジェクト参照を返す
Window.sessionStorage-
生成元のオリジンからのみアクセスが可能なデータを保存するために使用する、セッションストレージへの参照を返します。
-
サイドバーの window オブジェクトへの参照を返します。
Window.speechSynthesis読取専用-
SpeechSynthesisオブジェクトを返します。これは、ウェブ発声 API の音声合成機能を使用するためのエントリーポイントです。 Window.status非推奨-
ブラウザー下部のステータスバーのテキストを取得 / 設定します。
Window.statusbar読取専用-
ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な statusbar オブジェクトを返します。
Window.toolbar読取専用-
ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な toolbar オブジェクトを返します。
Window.top読取専用-
ウィンドウ階層における最上位のウィンドウへの参照を返します。このプロパティは読み取り専用です。
Window.visualViewport読取専用-
指定したウィンドウの視覚的なビューポートを表す
VisualViewport(en-US) オブジェクトを返します。 Window.window読取専用-
現在のウィンドウへの参照を返します。
window[0]、window[1]など-
フレーム内の
windowオブジェクトへの参照を返します。詳しくはWindow.framesをご覧ください。
他のところで実装されているプロパティ
caches読取専用-
現在のコンテキストに関連付けられた
CacheStorageオブジェクトを返します。このオブジェクトはオフラインで使用する資産を格納したり、リクエストに対して独自のレスポンスを生成したりするような機能が利用できます。 indexedDB読取専用-
Indexed データベースにアプリケーションが非同期にアクセスできる仕組みを提供します。このプロパティは
IDBFactoryオブジェクトを返します。 origin読取専用-
グローバルオブジェクトのオリジンを、文字列としてシリアライズして返します。
Window.scheduler(en-US) 読取専用-
現在のコンテキストに関連付けられた
Scheduler(en-US) オブジェクトを返します。 この点は、優先タスクスケジューリング API (en-US) を使用するためのエントリーポイントです。
廃止されたプロパティ
Window.contentおよびWindow._contentNon-standard 非推奨 読取専用-
現在のウィンドウでのコンテンツ要素への参照を返します。 Firefox 57 より (当初は Nightly のみ) どちらも chrome (特権付き) コードに限り使用でき、ウェブでは使用できません。
Window.defaultStatus非推奨-
指定ウィンドウのステータスバーのテキストを取得 / 設定
Window.orientation(en-US) 読取専用 非推奨Window.returnValue非推奨-
ウィンドウをモーダルダイアログとして表示する
window.showModalDialog()メソッドを呼び出した関数へ返却される返値です。
メソッド
このインターフェイスは EventTarget インターフェイスからメソッドを継承しています。
Window.alert()-
警告ダイアログを表示します。
Window.blur()-
ウィンドウからフォーカスを外します。
Window.cancelAnimationFrame()Experimental-
Window.requestAnimationFrameによって過去にスケジューリングされたコールバックをキャンセルできます。 Window.cancelIdleCallback()(en-US) Experimental-
Window.requestIdleCallbackによって過去にスケジューリングされたコールバックをキャンセルできます。 Window.clearImmediate()(en-US)-
setImmediateで設定した繰り返し処理をキャンセルします。 Window.close()-
現在のウィンドウを閉じます。
Window.confirm()-
ユーザーの応答が必要なメッセージを持つダイアログを表示します。
Window.dump()Non-standard-
コンソールにメッセージを出力します。
Window.find()-
ウィンドウ内で指定された文字列を検索します。
Window.focus()-
現在のウィンドウにフォーカスを当てます。
Window.getComputedStyle()-
特定の要素の計算済みスタイルを取得します。計算済みスタイルは、要素のすべての CSS プロパティの計算値を示します。
Window.getDefaultComputedStyle()(en-US) Non-standard-
特定の要素について、作者のスタイルシートを無視したデフォルトの計算済みスタイルを取得します。
Window.getSelection()-
選択されたアイテムを表す、セレクションオブジェクトを返します。
Window.matchMedia()-
指定したメディアクエリ文字列を表す
MediaQueryListオブジェクトを返します。 Window.moveBy()-
現在のウィンドウを指定した距離移動します。
Window.moveTo()-
ウィンドウを指定した位置に移動します。
Window.open()-
新しいウィンドウを開きます。
Window.postMessage()-
あるウィンドウから別のウィンドウへ、安全にデータ文字列を送信する手段を提供します。送信先ウィンドウは、送信元と同じドメインでなくてもかまいません。
Window.print()-
現在の文書を印刷するためのダイアログを開きます。
Window.prompt()-
ユーザーが入力ダイアログに入力したテキストを返します。
Window.requestAnimationFrame()-
アニメーションが進行中であることをブラウザーに伝えて、次のアニメーションフレームのためにウィンドウの再描画を予定するよう要求します。
Window.requestIdleCallback()Experimental-
ブラウザーがアイドル状態であるときに実行するタスクをスケジューリングします。
Window.resizeBy()-
現在のウィンドウを、指定した大きさの分だけ変更します。
Window.resizeTo()-
ウィンドウを動的にリサイズします。
Window.scroll()-
ウィンドウを文書内の特定の位置にスクロールします。
Window.scrollBy()-
ウィンドウ内の文書を、指定した距離の分だけスクロールします。
Window.scrollByLines()Non-standard-
文書を指定した行数分、スクロールします。
Window.scrollByPages()Non-standard-
文書を指定したページ数分、スクロールします。
Window.scrollTo()-
文書内の特定の位置に、ウィンドウをスクロールします。
Window.setImmediate()(en-US) Non-standard-
ブラウザーで他の高負荷なタスクが完了した後に、関数を実行します。
Window.setResizable()Non-standard-
ユーザーがウィンドウをリサイズできるかを切り替えます。
Window.sizeToContent()Non-standard-
コンテンツに応じてウィンドウのサイズを調整します。
Window.showOpenFilePicker()-
ユーザーがファイルまたは複数のファイルを選択できるファイルピッカーを表示します。
Window.showSaveFilePicker()-
ユーザーがファイルを保存するためのファイルピッカーを表示します。
Window.showDirectoryPicker()-
ディレクトリーを選択するピッカーが表示されます。
Window.stop()-
ウィンドウの読み込み処理を停止します。
Window.updateCommands()Non-standard-
現在の chrome ウィンドウ (UI) のコマンドの状態を更新します。
他のところで実装されているメソッド
EventTarget.addEventListener()-
ウィンドウの特定の種類のイベントにイベントハンドラーを登録します。
EventTarget.dispatchEvent()-
イベントを動作させるために使用します。
atob()-
Base64 エンコーディングを使用してエンコードされたデータの文字列をデコードします。
btoa()-
バイナリデータを Base64 でエンコードした ASCII 文字列を生成します。
clearInterval()-
setInterval()で繰り返し実行されるよう設定された命令をキャンセルします。 clearTimeout()-
setTimeout()で遅延実行するよう設定した命令をキャンセルします。 createImageBitmap()-
さまざまな画像ソースを受け入れて、
ImageBitmapに解決されるPromiseを返します。任意で、始点 (sx, sy) から幅 sw、高さ sh の長方形でソースを切り抜くことができます。 fetch()-
ネットワークからリソースを取り込む処理を開始します。
EventTarget.removeEventListener()-
window からイベントリスナーを削除します。
setInterval()-
ミリ秒単位で指定した時間が経過するたびに関数を実行するようスケジューリングします。
setTimeout()-
指定した時間が経過したら関数を実行するようスケジューリングします。
reportError()(en-US)-
処理されない例外をエミュレートして、スクリプトのエラーを報告します。
廃止されたメソッド
Window.back()Non-standard 非推奨-
ウィンドウの履歴をひとつ戻ります。このメソッドは廃止されました。代わりに
window.history.back()を使用してください。 Window.captureEvents()Non-standard 非推奨-
特定のタイプのイベントをすべてキャプチャするよう、ウィンドウに登録します。
Window.forward()Non-standard 非推奨-
履歴でひとつ先の文書に移動します。このメソッドは廃止されました。代わりに
window.history.forward()を使用してください。 Window.home()Non-standard 非推奨-
ブラウザーのホームページに戻ります。
Window.openDialog()(en-US) Non-standard 非推奨-
新しいダイアログウィンドウを開きます。
Window.releaseEvents()Non-standard 非推奨-
特定のタイプのイベントのキャプチャを解放します。
Window.showModalDialog()Non-standard 非推奨-
モーダルダイアログを表示します。
イベントハンドラー
これらは window オブジェクトのプロパティで、ウィンドウで発生する可能性がある、関心事となる可能性がある様々な出来事に対するイベントハンドラーを設定して有効にすることができます。
このインターフェイスは、 EventTarget インターフェイスからイベントハンドラーを継承しています。
Window.onuserproximity非推奨-
ユーザーの近接イベントのためのイベントハンドラープロパティです(
UserProximityEventを参照してください)。
他で実装されているイベントハンドラー
GlobalEventHandlers.onabort-
ユーザーが読み込み処理中にキャンセルしたなど、リソースの読み込みが異常終了した際に呼び出されます。
-
右マウスボタンを押したときに呼び出されます。
GlobalEventHandlers.onerror(en-US)-
リソースの読み込みが失敗したとき、あるいは実行時にエラーが発生したときに呼び出されます。
errorイベントをご覧ください。 GlobalEventHandlers.onload-
すべてのリソースおよび DOM が完全に読み込まれた後に呼び出されます。戻るボタンなどで、キャッシュからページが読み込まれたときは呼び出されません。
イベント
これらのイベントを待ち受けするには、 addEventListener() を使用するか、イベントリスナーをこのインターフェイスの onイベント名 プロパティに代入するかしてください。
error-
リソースの読み込みに失敗したか、利用できないときに発生します。例えば、スクリプトに実行エラーがあった場合や、画像が見つからなかったり、向こうであったりした場合です。
onerror(en-US) プロパティからも利用できます。 languagechange-
ユーザーの推奨される言語が変更されたときに、グローバルスコープオブジェクトに発生します。
orientationchange非推奨-
端末の向きが変化したときに発生します。
devicemotion-
定期的に発生し、利用できる場合は、端末にかかっている物理的な加速度の量と傾きを示します。
deviceorientation-
現在の端末の向きを地球の座標軸と比較する時期包囲センサーから新しいデータが利用できるようになったときに発生します。
resize-
ウィンドウのサイズが変更されたときに発行されます。
onresizeプロパティからも利用できます。 storage-
ストレージ領域 (
localStorageまたはsessionStorage) が他の文書のコンテキストから変更されたときに発生します。 vrdisplayconnect非推奨-
対応する VR 機器が接続されている場合に発行されます。
vrdisplaydisconnect非推奨-
対応する VR 機器がコンピューターから切り離されたときに発行されます。
vrdisplayactivate非推奨-
ディスプレイが表示できるようになったときに発行されます。
vrdisplaydeactivate非推奨-
ディスプレイが表示されなくなったときに発行されます。
vrdisplayblur非推奨-
ブラウザー、OS、VR ハードウェアの何らかの理由でディスプレイへの表示が一時停止されたときに発行されます。
vrdisplayfocus非推奨-
不鮮明であったディスプレイへの表示が再開されたときに発行されます。
vrdisplaypresentchange非推奨-
VR 機器の表示状態が変化したとき(表示から非表示、または非表示から非表示になったとき)に発行されます。
アニメーションイベント
animationcancel-
アニメーションが予期せず中断されたときに発生します。
onanimationcancel(en-US) プロパティからも利用できます。 animationend-
アニメーションが正常に終了したときに発生します。
onanimationend(en-US) プロパティからも利用できます。 animationiteration-
アニメーションが一巡したときに発生します。
onanimationiteration(en-US) プロパティからも利用できます。 animationstart-
アニメーションが開始されたときに発生します。
onanimationstart(en-US) プロパティからも利用できます。
クリップボードイベント
接続イベント
フォーカスイベント
ゲームパッドイベント
gamepadconnected-
ゲームパッドが接続された、またはゲームパッドのボタンや軸が初めて使用されたことをブラウザーが検出したときに発生します。
gamepaddisconnected-
ゲームパッドが切断されたことをブラウザーが検出したときに発生します。
履歴イベント
hashchange-
URL のフラグメント識別子 (URL の中で
#記号で始まり、それに続く部分) が変化したときに発生します。 pagehide-
ブラウザーが現在の文書を非表示にして、その場所にセッションの履歴とは異なる文書を表示するよう切り替えているときに送信されます。これはたとえば、ユーザーが「戻る」ボタンをクリックしたとき、または「進む」ボタンをクリックしてセッション履歴を先に進めたときに発生します。
pageshow-
ページが最初に読み込まれたときだけでなく、ユーザーが同じタブ内で別のページに移動した後にページに戻ったときなど、ナビゲーションタスクのためにブラウザーが文書を表示するときに送信されます。
popstate-
アクティブな履歴項目が変化したときに発生します。
ロード・アンロードイベント
beforeunload-
ウィンドウ、文書、そのリソースがアンロードされるときに発生します。
DOMContentLoaded-
文書が完全に読み込まれて解析されたときに、スタイルシート、画像、サブフレームの読み込みが完了するのを待たずに発生します。
load-
スタイルシートや画像などの依存するすべてのリソースを含め、ページ全体の読み込みが完了したときに発生します。
onloadプロパティからも利用できます。 unload-
文書や子リソースがアンロードされるときに発生します。
マニフェストイベント
appinstalled-
ブラウザーがページをアプリケーションとしてインストールすることに成功したときに発生します。
beforeinstallprompt(en-US)-
ウェブアプリケーションをインストールすることをユーザーに問い合わせようとするときに発生します。
メッセージイベント
message-
ウィンドウがメッセージを受け取ったとき、例えば他のブラウザーのコンテキストから
Window.postMessage()が呼び出された時に発生します。 messageerror-
Windowオブジェクトが復元できないメッセージを受信したときに発生します。
印刷イベント
afterprint-
関連づけられた文書の印刷が始まったか、印刷プレビューが閉じた後に発生します。
beforeprint-
関連づけられた文書の印刷が始まるか、印刷プレビューが表示されるときに発生します。
プロミス拒否イベント
rejectionhandled-
拒否を処理するハンドラーがあるかどうかにかかわらず、 JavaScript の
Promiseが拒否されるたびに送られます。 unhandledrejection-
JavaScript の
Promiseが拒否されたものの、拒否を処理するハンドラーがないときに送られます。
トランジションイベント
transitioncancel-
CSS トランジションが中止されたときに発生します。
ontransitioncancelプロパティからも利用できます。 transitionend-
CSS トランジションが完了したときに発生します。
ontransitionendプロパティからも利用できます。 transitionrun-
CSS トランジションが初めて作成されたときに発生します。
ontransitionrunプロパティからも利用できます。 transitionstart-
CSS トランジションが実際に開始されたときに発生します。
ontransitionstartプロパティからも利用できます。
WebVR イベント
vrdisplayactivate-
VR ディスプレイが表示する準備ができたとき、例えば HMD がスタンバイ状態に移行したり、装着して準備ができたときに発生します。
onvrdisplayactivate(en-US) プロパティからも利用できます。 vrdisplayblur-
ブラウザー、 OS、 VR ハードウェアの何れかが原因で、 VR ディスプレイの表示が停止したときに発生します。
onvrdisplayblur(en-US) プロパティからも利用できます。 vrdisplayconnect-
互換性のある VR ディスプレイがコンピューターに接続されたときに発生します。
onvrdisplayconnect(en-US) プロパティからも利用できます。 vrdisplaydeactivate-
VR ディスプレイが表示をやめる可能性があるとき、例えば HMD が一定時間使用されなかったためにスタンバイまたはスリープモードに入ったときなどに発生します。
onvrdisplaydeactivate(en-US) プロパティからも利用できます。 vrdisplaydisconnect-
互換性のある VR ディスプレイがコンピュータから切り離されたときに発生します。
onvrdisplaydisconnect(en-US) プロパティからも利用できます。 vrdisplayfocus-
VR ディスプレイへの表示を休んだ後で復帰したときに発生します。
onvrdisplayfocus(en-US) プロパティからも利用できます。 vrdisplaypresentchange-
VR ディスプレイの表示状態が変化したときに発生します。 — すなわち、表示を始めたり、表示を消したり、などです。
onvrdisplaypresentchange(en-US) プロパティからも利用できます。 vrdisplaypointerrestricted-
VR ディスプレイのポインター入力の消費が pointerlocked 要素によって抑止されたときに発生します。
onvrdisplaypointerrestricted(en-US) プロパティからも利用できます。 vrdisplaypointerunrestricted-
VR ディスプレイのポインター入力の消費が pointerlocked 要素によって抑止が解除されたときに発生します。
onvrdisplaypointerunrestricted(en-US) プロパティからも利用できます。
インターフェイス
DOM リファレンスをご覧ください。
仕様書
| Specification |
|---|
| HTML Standard # the-window-object |
ブラウザーの互換性
BCD tables only load in the browser