Location オブジェクト

Location オブジェクト

Locationオブジェクトは現在のURLに関する情報を含んでいます。

LocationオブジェクトはWindowオブジェクトの一部であり、window.location属性を通じてアクセスできます。

例

ユーザーを新しいアドレスにリダイレクトします。

Locationオブジェクトの属性

属性 説明
hash アンchor（井号#から始まる部分）を設定または返します。
host ホスト名とポート番号を設定または返します。
hostname ホスト名を設定または返します。
href 完全なURLを設定または返します。
pathname パス部分を設定または返します。
port ポート番号を設定または返します。
protocol プロトコルを設定または返します。
search クエリ（問号?から始まる部分）を設定または返します。

Locationオブジェクトのメソッド

属性 説明
assign() 新しいドキュメントをロードします。
reload() 現在のドキュメントを再読み込みします。
replace() 現在のドキュメントを新しいドキュメントで置き換えます。

Locationオブジェクトの説明

LocationオブジェクトはWindowオブジェクトのLocation属性に保存されており、そのウィンドウで現在表示されているドキュメントのWebアドレスを示しています。それの href属性ドキュメントの完全なURLが保存されており、他の属性はURLの各部分をそれぞれ説明しています。これらの属性は、Anchorオブジェクト（またはAreaオブジェクト）のURL属性と非常に似ています。Locationオブジェクトが文字列に変換された場合、href属性の値が返されます。これは、location.hrefをexpression locationで置き換えることができるという意味です。

不过 Anchor 对象表示的是文档中的超链接，Location 对象表示的却是浏览器当前显示的文档的 URL（或位置）。但是 Location 对象所能做的远远不止这些，它还能控制浏览器显示的文档的位置。如果把一个含有 URL 的字符串赋予 Location 对象或它的 href 属性，浏览器就会把新的 URL 所指的文档装载进来，并显示出来。

ただし、Anchor オブジェクトはドキュメント内のハイパーリンクを表現し、Location オブジェクトはブラウザが現在表示しているドキュメントの URL（または位置）を表現しています。しかし、Location オブジェクトはこれ以上のことができます。それは、ブラウザが表示するドキュメントの位置を制御することもできます。URLを含む文字列を Location オブジェクトまたはその href プロパティに割り当てると、ブラウザは新しい URL が指すドキュメントをロードし表示します。 除いて location または location.href を完全な URL で現在の URL を置き換える以外に、部分 URL を変更することもできます。これは、Location オブジェクトの他の属性に値を設定することで実現されます。これにより、一部が元の URL と異なる新しい URL が作成され、ブラウザがそれをロードし表示します。例えば、Location オブジェクトのそれでは、ブラウザは現在のドキュメント内の指定された位置に移動します。同様に、hash プロパティが設定されている場合 search プロパティそれでは、ブラウザは新しいクエリ文字列が付加された URL を再ロードします。

URL 属性以外に、Location オブジェクトの reload() メソッド現在のドキュメントを再ロードすることができます。replace() 新しいドキュメントを新しい履歴として作成する必要なく、新しいドキュメントをロードすることができます。つまり、ブラウザの履歴リストでは、新しいドキュメントが現在のドキュメントを置き換えます。