Window
Window
インターフェイスは、 DOM 文書を収めるウィンドウを表します。 document
プロパティは、そのウィンドウに読み込まれた DOM の document オブジェクト を指します。
特定の文書が属するウィンドウは、 document.defaultView
プロパティを使用して取得できます。
グローバル変数の window
は、スクリプトを実行しているウィンドウを表しており、 JavaScript コードに公開されます。
Window
インターフェイスは、ユーザーインターフェイスのウィンドウの概念とは必ずしも直接関連づかない、さまざまな関数、名前空間、オブジェクト、コンストラクターのホームです。一方、 Window
インターフェイスはグローバルで使用可能であることが必要な、さまざまなアイテムを含むのに適した場所です。これらの多くは JavaScript リファレンス や DOM リファレンス で文書化しています。
タブブラウザーでは、それぞれのタブが個々の Window
オブジェクトで表されます。タブ内で実行している JavaScript から見えるグローバルの window
は、常にコードを実行しているタブを表します。しかし、タブブラウザーであっても resizeTo()
や innerHeight
のように、タブを含むウィンドウ全体に適用されるプロパティやメソッドがあります。一般に、タブに所属することができない合理的な理由があるものは、代わりにウィンドウに属します。
インスタンスプロパティ
このインターフェイスは EventTarget
インターフェイスからプロパティを継承しています。
オブジェクトであるプロパティ(例えば、組み込み要素のプロトタイプを上書きするためのもの)は、後述の個別セクションに記載しています。
Window.caches
読取専用-
現在のコンテキストに関連付けられた
CacheStorage
オブジェクトを返します。このオブジェクトはオフラインで使用する資産を格納したり、リクエストに対して独自のレスポンスを生成したりするような機能が利用できます。 Window.clientInformation
読取専用-
Window.navigator
の別名です。 Window.closed
読取専用-
このプロパティは、現在のウィンドウが閉じているかどうかを示します。
Window.console
読取専用-
ブラウザーのデバッグコンソールへアクセスするための console オブジェクトへの参照を返します。
-
現在の文書コンテキストの
CookieStore
オブジェクトへの参照を返します。 Window.credentialless
読取専用 Experimental-
現在の文書が 無信頼の
<iframe>
内で読み込まれたかどうかを示す論理値を返します。詳しくは無信頼の iframe を参照してください。 Window.crossOriginIsolated
読取専用-
ウェブサイトがオリジン間分離状態にあるかどうかを示す論理値を返します。
Window.crypto
読取専用-
グローバルオブジェクトに関連付けられた
Crypto
オブジェクトを返します。 Window.customElements
読取専用-
CustomElementRegistry
オブジェクトへの参照を返します。これは新しいカスタム要素の登録や、以前に登録したカスタム要素の情報を取得するために使用できます。 Window.devicePixelRatio
読取専用-
現在のディスプレイの、物理ピクセルと端末非依存ピクセルの比率を返します。
Window.document
読取専用-
指定ウィンドウにある文書への参照を返します。
Window.documentPictureInPicture
読取専用 Experimental 安全なコンテキスト用-
現在の文書コンテキストのピクチャインピクチャウィンドウへの参照を返します。
Window.fence
読取専用 Experimental-
現在の文書コンテキストの
Fence
オブジェクトインスタンスを返します。<fencedframe>
内に埋め込まれた文書でのみ利用できます。 Window.frameElement
読取専用-
ウィンドウが埋め込まれた要素を返します。ウィンドウが埋め込まれていない場合は、 null を返します。
Window.frames
読取専用-
現在のウィンドウでのサブフレームの配列を返します。
Window.fullScreen
Non-standard-
このプロパティはウィンドウが全画面で表示されているかどうかを示します。
Window.history
読取専用-
history オブジェクトへの参照を返します。
Window.indexedDB
読取専用-
索引付きデータベースにアプリケーションが非同期にアクセスできる仕組みを提供します。このプロパティは
IDBFactory
オブジェクトを返します。 Window.innerHeight
読取専用-
ブラウザーウィンドウのコンテンツ領域の高さを取得し、もしあれば、水平スクロールバーを含みます。
Window.innerWidth
読取専用-
ブラウザーウィンドウのコンテンツ領域の幅を取得し、もしあれば、垂直スクロールバーを含みます。
Window.isSecureContext
読取専用-
コンテキストが、安全なコンテキストを必要とする機能を使用することができるかどうかを表します。
Window.launchQueue
読取専用 Experimental-
プログレッシブウェブアプリ (PWA) が、
launch_handler
のclient_mode
がfocus-existing
、navigate-new
、navigate-existing
のいずれかで起動された場合、launchQueue
はLaunchQueue
クラスへのアクセスを提供し、PWA にカスタム起動ナビゲーション処理を実装することができます。 Window.length
読取専用-
ウィンドウ内のフレームの数を返します。
window.frames
も参照してください。 Window.localStorage
読取専用-
生成元のオリジンからのみアクセスが可能なデータを保存するために使用する、ローカルストレージオブジェクトへの参照を返します。
Window.location
-
window オブジェクトのロケーション、または現在の URL を取得 / 設定します。
Window.locationbar
読取専用-
locationbar オブジェクトを返します。
-
menubar オブジェクトを返します。
Window.mozInnerScreenX
読取専用 Non-standard-
スクリーン座標系でウィンドウのビューポートの左上隅の水平 (X) 座標を返します。この値は CSS ピクセルで表します。必要に応じて画面のピクセルに換算するための係数については、
nsIDOMWindowUtils
のmozScreenPixelsPerCSSPixel
をご覧ください。 Window.mozInnerScreenY
読取専用 Non-standard-
スクリーン座標系で、ウィンドウビューポートの左上隅の垂直 (Y) 座標を返します。この値は CSS ピクセルで表します。必要に応じて画面のピクセルに換算するための係数については
mozScreenPixelsPerCSSPixel
をご覧ください。 Window.name
-
ウィンドウ名を取得 / 設定します。
-
現在の
window
に関連付けられたNavigation
オブジェクトを返します。Navigation API
のエントリーポイントです。 -
navigator オブジェクトへの参照を返します。
Window.opener
-
現在のウィンドウを開いたウィンドウへの参照を返します。
Window.origin
読取専用-
グローバルオブジェクトのオリジンを、文字列としてシリアライズして返します。
Window.originAgentCluster
読取専用 Experimental-
このウィンドウがオリジンキーエージェントクラスターに属している場合は
true
を返します。 Window.outerHeight
読取専用-
ブラウザーウィンドウの外側の高さを取得します。
Window.outerWidth
読取専用-
ブラウザーウィンドウの外側の幅を取得します。
Window.pageXOffset
読取専用-
window.scrollX
のエイリアスです。 Window.pageYOffset
読取専用-
window.scrollY
のエイリアスです。 Window.parent
読取専用-
現在のウィンドウまたはサブフレームの親ウィンドウへの参照を返します。
Window.performance
読取専用-
Performance
オブジェクトを返します。これはtiming
やnavigation
属性が含まれており、それぞれが パフォーマンス関連 のデータを提供するオブジェクトです。詳細情報や使用例はナビゲーションタイミングの使用をご覧ください。 Window.personalbar
読取専用-
personalbar オブジェクトを返します。
Window.scheduler
読取専用-
現在のコンテキストに関連付けられた
Scheduler
オブジェクトを返します。この項目は優先タスクスケジューリング API を使用するためのエントリーポイントです。 Window.screen
読取専用-
ウィンドウに関連付けられた screen オブジェクトへの参照を返します。
Window.screenX
およびWindow.screenLeft
読取専用-
どちらのプロパティも、ユーザーのブラウザーのビューポートの左端から画面の左端までの水平方向の距離を返します。
Window.screenY
およびWindow.screenTop
読取専用-
どちらのプロパティも、ユーザーのブラウザーのビューポートの上端から画面の上端までの垂直方向の距離を返します。
Window.scrollbars
読取専用-
ウィンドウ内で表示 / 非表示の切り替え (トグル) が可能な、 scrollbars オブジェクトを返す
Window.scrollMaxX
Non-standard 読取専用-
ウィンドウが水平スクロールされ得る最大オフセット、すなわち、文書の幅からビューポートの幅を引いたものです。
Window.scrollMaxY
Non-standard 読取専用-
ウィンドウが垂直スクロールされ得る最大オフセット (すなわち、文書の高さからビューポートの高さを引いたもの) です。
Window.scrollX
読取専用-
文書が現在水平にスクロールされているピクセル数を返します。
Window.scrollY
読取専用-
文書が現在垂直にスクロールされているピクセル数を返します。
Window.self
読取専用-
window オブジェクト自身へのオブジェクト参照を返す
Window.sessionStorage
-
生成元のオリジンからのみアクセスが可能なデータを保存するために使用する、セッションストレージへの参照を返します。
-
現在のオリジンの
WindowSharedStorage
オブジェクトを返します。これは共有ストレージ API を使用して共有ストレージにデータを書き込むためのメインエントリーポイントです。 Window.speechSynthesis
読取専用-
SpeechSynthesis
オブジェクトを返します。これは、ウェブ発声 API の音声合成機能を使用するためのエントリーポイントです。 Window.statusbar
読取専用-
statusbar オブジェクトを返します。
Window.toolbar
読取専用-
toolbar オブジェクトを返します。
Window.top
読取専用-
ウィンドウ階層における最上位のウィンドウへの参照を返します。このプロパティは読み取り専用です。
Window.trustedTypes
読取専用-
グローバルオブジェクトに関連付けられた
TrustedTypePolicyFactory
オブジェクトを返します。これは信頼型 API を使用するためのエントリーポイントです。 Window.visualViewport
読取専用-
指定したウィンドウの視覚的なビューポートを表す
VisualViewport
オブジェクトを返します。 Window.window
読取専用-
現在のウィンドウへの参照を返します。
window[0]
、window[1]
など-
フレーム内の
window
オブジェクトへの参照を返します。詳しくはWindow.frames
をご覧ください。
非推奨のプロパティ
Window.event
非推奨 読取専用-
現在のイベントを返します。これは現在 JavaScript のコードのコンテキストが処理しているイベントです。また、現在処理しているイベントがない場合は
undefined
を返します。可能な限り、イベントハンドラーに直接渡したEvent
オブジェクトを代わりに使用してください。 Window.external
非推奨 読取専用-
外部の検索プロバイダーをブラウザーに追加するための関数を持つオブジェクトを返します。
Window.orientation
非推奨 読取専用-
端末の自然な方向に対するビューポートの方向を度単位(90 度単位で増加)で返します。
-
サイドバーの window オブジェクトへの参照を返します。
Window.status
非推奨-
ブラウザー下部のステータスバーのテキストを取得 / 設定します。
インスタンスメソッド
このインターフェイスは EventTarget
インターフェイスからメソッドを継承しています。
Window.atob()
-
Base64 エンコーディングを使用してエンコードされたデータの文字列をデコードします。
Window.alert()
-
警告ダイアログを表示します。
Window.blur()
非推奨-
ウィンドウからフォーカスを外します。
Window.btoa()
-
バイナリーデータを Base64 でエンコードした ASCII 文字列を生成します。
Window.cancelAnimationFrame()
-
Window.requestAnimationFrame
によって過去にスケジューリングされたコールバックをキャンセルできます。 Window.cancelIdleCallback()
-
Window.requestIdleCallback
によって過去にスケジューリングされたコールバックをキャンセルできます。 Window.clearInterval()
-
setInterval()
で繰り返し実行されるよう設定された命令をキャンセルします。 Window.clearTimeout()
-
setTimeout()
で遅延実行するよう設定した命令をキャンセルします。 Window.close()
-
現在のウィンドウを閉じます。
Window.confirm()
-
ユーザーの応答が必要なメッセージを持つダイアログを表示します。
Window.createImageBitmap()
-
さまざまな画像ソースを受け入れ、
ImageBitmap
に解決されるPromise
を返します。任意で、始点 (sx, sy) から幅 sw、高さ sh の長方形でソースを切り抜くことができます。 Window.dump()
Non-standard-
コンソールにメッセージを出力します。
Window.fetch()
-
ネットワークからリソースを取り込む処理を開始します。
Window.find()
Non-standard-
ウィンドウ内で指定された文字列を検索します。
Window.focus()
-
現在のウィンドウにフォーカスを当てます。
Window.getComputedStyle()
-
特定の要素の計算済みスタイルを取得します。計算済みスタイルは、要素のすべての CSS プロパティの計算値を示します。
Window.getDefaultComputedStyle()
Non-standard-
特定の要素について、作者のスタイルシートを無視したデフォルトの計算済みスタイルを取得します。
Window.getScreenDetails()
Experimental 安全なコンテキスト用-
ユーザーの端末で利用できるすべての画面の詳細を表す
ScreenDetails
オブジェクトインスタンスで履行されるPromise
を返します。 Window.getSelection()
-
選択されたアイテムを表す、セレクションオブジェクトを返します。
Window.matchMedia()
-
指定したメディアクエリー文字列を表す
MediaQueryList
オブジェクトを返します。 Window.moveBy()
-
現在のウィンドウを指定した距離移動します。
Window.moveTo()
-
ウィンドウを指定した位置に移動します。
Window.open()
-
新しいウィンドウを開きます。
Window.postMessage()
-
あるウィンドウから別のウィンドウへ、安全にデータ文字列を送信する手段を提供します。送信先ウィンドウは、送信元と同じドメインでなくてもかまいません。
Window.print()
-
現在の文書を印刷するためのダイアログを開きます。
Window.prompt()
-
ユーザーが入力ダイアログに入力したテキストを返します。
Window.queryLocalFonts()
Experimental 安全なコンテキスト用-
ローカルで利用できるフォントフェイスを表す
FontData
オブジェクトの配列で履行されたPromise
を返します。 Window.queueMicrotask()
-
ブラウザーのイベントループに制御を返す前に、安全な時点で実行されるマイクロタスクをキューに入れます。
Window.reportError()
-
処理されない例外をエミュレートして、スクリプトのエラーを報告します。
Window.requestAnimationFrame()
-
アニメーションが進行中であることをブラウザーに伝えて、次のアニメーションフレームのためにウィンドウの再描画を予定するよう要求します。
Window.requestIdleCallback()
-
ブラウザーがアイドル状態であるときに実行するタスクをスケジューリングします。
Window.resizeBy()
-
現在のウィンドウを、指定した大きさの分だけ変更します。
Window.resizeTo()
-
ウィンドウを動的にリサイズします。
Window.scroll()
-
ウィンドウを文書内の特定の位置にスクロールします。
Window.scrollBy()
-
ウィンドウ内の文書を、指定した距離の分だけスクロールします。
Window.scrollByLines()
Non-standard-
文書を指定した行数分、スクロールします。
Window.scrollByPages()
Non-standard-
文書を指定したページ数分、スクロールします。
Window.scrollTo()
-
文書内の特定の位置に、ウィンドウをスクロールします。
Window.setInterval()
-
ミリ秒単位で指定した時間が経過するたびに関数を実行するようスケジューリングします。
Window.setTimeout()
-
指定した時間が経過したら関数を実行するようスケジューリングします。
Window.showDirectoryPicker()
Experimental 安全なコンテキスト用-
ユーザーがディレクトリーを選択できるディレクトリーピッカーを表示します。
Window.showOpenFilePicker()
Experimental 安全なコンテキスト用-
ユーザーがファイルまたは複数のファイルを選択できるファイルピッカーを表示します。
Window.showSaveFilePicker()
Experimental 安全なコンテキスト用-
ユーザーがファイルを保存できるファイルピッカーを表示します。
Window.sizeToContent()
Non-standard-
コンテンツに応じてウィンドウのサイズを調整します。
Window.stop()
-
ウィンドウの読み込み処理を停止します。
Window.structuredClone()
-
指定された値のディープクローンを、構造化クローンアルゴリズムを用いて作成します。
Window.updateCommands()
Non-standard-
現在の chrome ウィンドウ (UI) のコマンドの状態を更新します。
非推奨のメソッド
Window.back()
Non-standard 非推奨-
ウィンドウの履歴をひとつ戻ります。このメソッドは廃止されました。代わりに
window.history.back()
を使用してください。 Window.captureEvents()
非推奨-
特定のタイプのイベントをすべてキャプチャするよう、ウィンドウに登録します。
Window.clearImmediate()
Non-standard 非推奨-
setImmediate
で設定した繰り返し処理をキャンセルします。 Window.forward()
Non-standard 非推奨-
履歴でひとつ先の文書に移動します。このメソッドは廃止されました。代わりに
history.forward()
を使用してください。 Window.releaseEvents()
非推奨-
特定のタイプのイベントのキャプチャを解放します。
Window.requestFileSystem()
Non-standard 非推奨-
ウェブサイトやアプリが自分自身で使用するためにサンドボックス化されたファイルシステムにアクセスすることができます。
Window.setImmediate()
Non-standard 非推奨-
ブラウザーで他の高負荷なタスクが完了した後に、関数を実行します。
Window.setResizable()
Non-standard 非推奨-
ユーザーがウィンドウをリサイズできるかを切り替えます。
Window.showModalDialog()
Non-standard 非推奨-
モーダルダイアログを表示します。
Window.webkitConvertPointFromNodeToPage()
Non-standard 非推奨-
ノードの座標系からページの座標系へ
WebKitPoint
を変換します。 Window.webkitConvertPointFromPageToNode()
Non-standard 非推奨-
ページの座標系からノードの座標系へ
WebKitPoint
を変換します。
イベント
これらのイベントを待ち受けするには、 addEventListener()
を使用するか、イベントリスナーをこのインターフェイスの onイベント名
プロパティに代入するかしてください。下記の一覧のイベントに加えて、多くのイベントがウィンドウオブジェクトに格納されている Document
からバブリングしてくる可能性があります。
error
-
リソースの読み込みに失敗したか、利用できないときに発生します。例えば、スクリプトに実行エラーがあった場合や、画像が見つからなかったり、無効であったりした場合です。
languagechange
-
ユーザーの推奨される言語が変更されたときに、グローバルスコープオブジェクトに発生します。
resize
-
ウィンドウのサイズが変更されたときに発行されます。
storage
-
ストレージ領域 (
localStorage
またはsessionStorage
) が他の文書のコンテキストから変更されたときに発生します。
クリップボードイベント
接続イベント
端末方向イベント
devicemotion
安全なコンテキスト用-
定期的に発生し、利用できる場合は、端末にかかっている物理的な加速度の量と傾きを示します。
deviceorientation
安全なコンテキスト用-
現在の端末の向きを地球の座標軸と比較する時期包囲センサーから新しいデータが利用できるようになったときに発生します。
deviceorientationabsolute
安全なコンテキスト用-
磁力計の方位センサーから、地球座標フレームと比較した端末の現在の絶対方位に関する新しいデータが利用できる場合に発行されます。
フォーカスイベント
ゲームパッドイベント
gamepadconnected
-
ゲームパッドが接続された、またはゲームパッドのボタンや軸が初めて使用されたことをブラウザーが検出したときに発生します。
gamepaddisconnected
-
ゲームパッドが切断されたことをブラウザーが検出したときに発生します。
履歴イベント
hashchange
-
URL のフラグメント識別子 (URL の中で
#
記号で始まり、それに続く部分) が変化したときに発生します。 pagehide
-
ブラウザーが現在の文書を非表示にして、その場所にセッションの履歴とは異なる文書を表示するよう切り替えているときに送信されます。これはたとえば、ユーザーが「戻る」ボタンをクリックしたとき、または「進む」ボタンをクリックしてセッション履歴を先に進めたときに発生します。
pageshow
-
ページが最初に読み込まれたときだけでなく、ユーザーが同じタブ内で別のページに移動した後にページに戻ったときなど、ナビゲーションタスクのためにブラウザーが文書を表示するときに送信されます。
popstate
-
アクティブな履歴項目が変化したときに発生します。
ロード・アンロードイベント
beforeunload
-
ウィンドウ、文書、そのリソースがアンロードされるときに発生します。
load
-
スタイルシートや画像などの依存するすべてのリソースを含め、ページ全体の読み込みが完了したときに発生します。
unload
-
文書や子リソースがアンロードされるときに発生します。
マニフェストイベント
appinstalled
-
ブラウザーがページをアプリケーションとしてインストールすることに成功したときに発生します。
beforeinstallprompt
-
ウェブアプリケーションをインストールすることをユーザーに問い合わせようとするときに発生します。
メッセージイベント
message
-
ウィンドウがメッセージを受け取ったとき、例えば他のブラウザーのコンテキストから
Window.postMessage()
が呼び出された時に発生します。 messageerror
-
Window
オブジェクトが復元できないメッセージを受信したときに発生します。
印刷イベント
afterprint
-
関連づけられた文書の印刷が始まったか、印刷プレビューが閉じた後に発生します。
beforeprint
-
関連づけられた文書の印刷が始まるか、印刷プレビューが表示されるときに発生します。
プロミス拒否イベント
rejectionhandled
-
拒否を処理するハンドラーがあるかどうかにかかわらず、 JavaScript の
Promise
が拒否されるたびに送られます。 unhandledrejection
-
JavaScript の
Promise
が拒否されたものの、拒否を処理するハンドラーがないときに送られます。
非推奨のイベント
orientationchange
非推奨-
端末の向きが変化したときに発生します。
vrdisplayactivate
非推奨 Non-standard-
ディスプレイが表示できるようになったときに発行されます。
vrdisplayconnect
非推奨 Non-standard-
対応する VR 機器が接続されている場合に発行されます。
vrdisplaydisconnect
非推奨 Non-standard-
対応する VR 機器がコンピューターから切り離されたときに発行されます。
vrdisplaydeactivate
非推奨 Non-standard-
ディスプレイが表示されなくなったときに発行されます。
vrdisplaypresentchange
非推奨 Non-standard-
VR 機器の表示状態が変化したとき(表示から非表示、または非表示から非表示になったとき)に発行されます。
インターフェイス
DOM リファレンスをご覧ください。
仕様書
Specification |
---|
HTML Standard # the-window-object |
ブラウザーの互換性
BCD tables only load in the browser