技術のメモ箱

JavaScript/Windowオブジェクト

概要

Windowオブジェクトはブラウザを操作するためのWebAPI。
自分で生成しなくてもあらかじめwindowという識別子で使える状態になっている。
Windowオブジェクトはグローバルオブジェクトという特別なものなので、windowを省略して使うことができる。

MDN: Window

メソッド

画面制御に関するメソッド。

メソッド説明
alert(str)指定した文字列を画面のダイアログに表示する。
confirm(str)指定した文字列と[OK][キャンセル]ボタンをダイアログに表示する。
[OK]が押された場合はtrueが返される。
prompt(question [, default])指定した文字列とテキスト入力欄をダイアログに表示する。
テキスト入力欄のデフォルト値はdefaultで指定可能。
入力された文字が戻り値となる。
close()現在表示中のウィンドウを閉じる。
open(url [, windowName, windowFeatures])urlで指定したページをwindowNameで指定した画面で開く。
新しい画面で開くには、_blankを指定する。
windowFeaturesで表示位置や大きさを指定可能。
scrollBy(x, y)現在の位置を基準に水平方向(x)、垂直方向(y)へスクロールする。
scrollBy(option)現在の位置を基準にオブジェクト形式で指定した位置へスクロールする。
・top: 垂直方向
・left: 水平方向
・behavior: auto、instant、smoothのいずれか
scroll(x-coord, y-coord)
scrollTo(x-coord, y-coord)
HTMLの左上を基準に水平方向(x)、垂直方向(y)へスクロールする。
scroll(option)
scrollTo(option)
HTMLの左上を基準にオブジェクト形式で指定した位置へスクロールする。
・top: 垂直方向
・left: 水平方向
・behavior: auto、instant、smoothのいずれか

タスク制御に関するメソッド。

メソッド説明
setTimeout(fn [, delay, arg1, arg2, ...])関数fnをdelayミリ秒後に実行するタスクを登録する。
argで渡した引数は関数fnに渡される。
戻り値としてtimeoutIDが返る。
setInterval(fn [, interval, arg1, arg2, ...])関数fnをintervalミリ秒毎に実行するタスクを登録する。
argで渡した引数は関数fnに渡される。
戻り値としてintervalIDが返る。
requestAnimationFrame(fn)関数fnの実行を次の再描画の前に行うタスクを登録する。
queueMicrotask(fn)関数fnをマイクロタスク(ジョブキュー)に登録する。
clearTimeout(timeoutID)timeoutIDのタスクをキャンセルする。
clearInterval(intervalID)intervalIDのタスクをキャンセルする。
cancelAnimationFrame(requestID)requestIDのタスクをキャンセルする。

その他のメソッド。

メソッド説明
btoa(str)文字列をBase64形式のエンコード文字列に変換する。
atob(encodedStr)Base64形式のエンコード文字列を文字列に変換する。
postMessage(message, targetOrigin [, transfer])Windowオブジェクト間のメッセージのやり取りを行う。

プロパティ

画面に関するプロパティ。

プロパティ説明
innerWidthスクロールバーを含む、ブラウザウィンドウの描画領域の横幅。
innerHeightスクロールバーを含む、ブラウザウィンドウの描画領域の高さ。
outerWidthメニューバーなどを含めたブラウザウィンドウ全体の横幅。
outerHeightメニューバーなどを含めたブラウザウィンドウ全体の高さ。
pageXOffset水平方向へのスクロール量。
scrollX
pageYOffset垂直方向へのスクロール量。
scrollY
screenLeftディスプレイに対するブラウザウィンドウの水平方向の位置。
screenX
screenTopディスプレイに対するブラウザウィンドウの垂直方向の位置。
screenY

Windowオブジェクトに関するプロパティ。

プロパティ説明
selfWindowオブジェクトのエイリアス。
frameswindow内のiframeを配列風オブジェクトとして返す。
parent現在のwindowの親のWindowオブジェクトを返す。
topウィンドウの階層で最上位のWindowオブジェクトを返す。
pagetop