Location

Location インターフェイスは、関連付けられたオブジェクトの場所 (URL) を表します。 Location に対して変更が行われると、関連するオブジェクトに反映されます。 Document インターフェイスおよび Window インターフェイスにはこのような関連付けられた Location があり、それぞれ Document.location および Window.location でアクセスできます。

プロパティ

Location.href (en-US)
URL 全体を収めた USVString を返す文字列化です。この値を変更すると、関連付けられた文書が新しいページへ移動します。この値は、関連付けられた文書のものとは異なるオリジンから設定できます。
Location.protocol (en-US)
末尾の ':' を含む、URL のプロトコルスキームを収めた USVString です。
Location.host (en-US)
URL のホスト (すなわち hostname、コロン (':')、port) を収めた USVString です。
Location.hostname (en-US)
URL のドメインを収めた USVString です。
Location.port (en-US)
URL のポート番号を収めた USVString です。
Location.pathname (en-US)
URL のパス部分を、先頭の '/' を含めて収めた USVString です。
Location.search (en-US)
URL のうち、'?' とそれに続くパラメーターや "クエリー文字列" を収めた USVString です。現代のブラウザーは、クエリー文字列からパラメーターを容易に解析するための URLSearchParamsURL.searchParams を提供しています。
Location.hash (en-US)
URL のうち、'#' とそれに続くフラグメント識別子を収めた USVString です。
Location.username (en-US)
ドメイン名の前に指定されたユーザー名を収めた USVString です。
Location.password (en-US)
ドメイン名の前に指定されたパスワードを収めた USVString です。
Location.origin (en-US) 読取専用
特定の location のオリジンの標準形を収めた USVString です。

メソッド

Location.assign() (en-US)
引数で指定した URL のリソースを読み込みます。
Location.reload()
現在の URL のリソースを再読み込みします。省略可能な唯一の引数は Boolean 値で、true であれば常にサーバーからページを再読み込みします。false を指定するか値を指定しない場合は、ブラウザーがキャッシュからページを再読み込みする可能性があります。
Location.replace() (en-US)
現在のリソースを、指定した URL のリソースで置き換えます。assign() メソッドとの違いは、replace() を使用した後は現在のページがセッションの History に保存されないことであり、ユーザーは 戻る ボタンを使用して移動することができません。
Location.toString() (en-US)
URL 全体を収めた USVString を返します。これは HTMLHyperlinkElementUtils.href と同義ですが、こちらは値を変更するために使用できません。

// この例のためにアンカー要素を生成して、href プロパティを使用します。
// より適切な代替手段は、URL を見て document.location または window.location を使用することです。
var url = document.createElement('a');
url.href = 'https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container';
console.log(url.href);      // https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container
console.log(url.protocol);  // https:
console.log(url.host);      // developer.mozilla.org:8080
console.log(url.hostname);  // developer.mozilla.org
console.log(url.port);      // 8080
console.log(url.pathname);  // /en-US/search
console.log(url.search);    // ?q=URL
console.log(url.hash);      // #search-results-close-container
console.log(url.origin);    // https://developer.mozilla.org:8080

仕様書

仕様書 状態 備考
HTML Living Standard
Location の定義
現行の標準 HTML5 から変更なし。
HTML5
Location の定義
勧告 初回定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報