備忘録的プログラミングリファレンス

Location インターフェイス

Window.location
Document.location

 Location インターフェイスは、 URL の取得とページの更新、移動に関するインターフェイスです。

 このインターフェイスは URL 全体、ドメイン名のみ、ポート番号、ホスト名など詳細なデータを取得できるプロパティをもちます。
 メソッドに関しては、ページの移動やリロードなどができます。

ページの再読み込み
location.reload();

詳しくは Example を参照しください

 Location インターフェイスは、window.locationdocument.locationgetElementsByTagName('a')[0].location によって取得ができます。

 上記の例はwindow.locationの window を省略したものです。window.location の window は省略可能で、上記は window.location.reload(); とも記述できます。

ページ内 Index

プロパティ(Properties)

プロパティ名説明
href現在のURLの情報を取得。値を変更するとそのURL先に移動します。
protocol末尾の':'を含んだプロトコルを取得。
hostホスト名の取得
hostnameドメイン名の取得
portポート番号の取得
pathname'/'まで含めたパス名の取得
search'?'以降の文字列の取得。'?'を含むパラメーターやクエリー文字列の情報の取得ができます。
hash'#'以降の情報の取得
usernameユーザー名の取得(削除予定のプロパティです)
passwordパスワードの取得(削除予定のプロパティです)
originlocationの標準のオリジンを取得

メソッド(Methods)

メソッド名説明
assign()引数に指定したURLへ移動。Historyに記録されて、戻ることができる。戻れないようにするには、replace()メソッドを使う。
reload(true/false)現在のURLの再読込を実行。引数を指定しないまたはfalseでキャッシュから読み込み。trueでサーバーから読み込み。
replace()引数に指定したURLへ移動。このメソッドを利用するとHistoryに記録されないために戻ることができない。戻るようにするには、assign() メソッドを使う
toString()URL全体の情報を取得。値の変更にはHTMLHyperlinkElementUtils.hrefを使います。

Example

 Location インターフェイスのメソッド parent.document.location.reload(); の使用例です。

 この例では parent.document によってこのページ自体の再読み込みを行います。

確認ボタンをクリックしてください。以下のHTML,CSS,Scriptコード例が実行されます。

 オブジェクト指向におけるインターフェイスはクラスのようにプロパティやメソッドが定義されていますがオブジェクトとして生成できません。別々のクラスで共通したプロパティやメソッドといった機能を拡充することができます。
 インターフェイスによって継承という形をとらないでオブジェクトでプロパティやメソッドといった機能を拡充することができます。
 JavaScript では Window や Document インターフェイスなどクラスではなくインターフェイスと定義されているものが多々あります。これはクラスの継承ではないためです。この点はややこしく感じるかもしれません。