window.location

概要

文書の URL についての情報を含み、また、URL を変更するためのメソッドを提供をする、 Location オブジェクト を返します。別の URL を読み込ませるために、このプロパティに URL を代入することもできます。

構文

varlocationObj = window.location;
window.location =newLocation;

• locationObjは、 現在の URL の情報とそれを変更するためのメソッドを提供する、Location 型のオブジェクトです。 プロパティとメソッドは、以下で説明されています。
• newLocationは、 Location オブジェクト、または、文字列です。訪問させたい URL を指定します。

Location オブジェクト

このセクションでは、Location オブジェクトのプロパティとメソッドを説明しています。

文字列としての使用

Location オブジェクトは、現在の URL を返す toString メソッドを持っています。window.location へ文字列を代入することもできます。これは、ほとんどのケースで、window.location が、文字列であるかのように動作することを意味します。このオブジェクトに対して String のメソッドを呼び出す必要があるとき、toString を明示的に toString を呼び出す必要があります。そのような例:

alert(window.location.toString().charAt(17))

プロパティ

以下のプロパティの全ては文字列です。現在の URL についての情報を取得するために、それらを読み込んだり、別の URL を訪問させるために、それらを設定することができます。

"例" の列は、次の URL のプロパティの値を含んでいます。:

• https://www.google.com:80/search?q=devmo#test

URL の hash の部分が、エンコードされた文字（Core_JavaScript_1.5_Reference:Global_Functions:encodeURIComponent を参照）を含む場合、hash は、デコードされた URL の部分を返します。これは、Firefox における、バグです。href、search、pathname は、正しい、エンコードされた URL の部分を返します。 例:

• https://www.google.com/search?q=Fire%20fox#Fire%20fox

結果:

• hash=#Fire fox
• search=?q=Fire%20fox

メソッド

例

location オブジェクトのプロパティが変更されるときはいつでも、文書は、window.location.assign() が変更された URL を引数にして呼び出されたときのように、URL を読み込みます。

現在の文書を与えられた URL で置き換えます。:

function goMoz() {
   window.location = "https://www.mozilla.org";
}

// html で: <button onclick="goMoz();">Mozilla</button>

現在の URL のプロパティを警告ダイアログで表示します。:

 function showLoc()
 {
   var x = window.location;
   var t = ['Property - Typeof - Value',
            'window.location - ' + (typeof x) + ' - ' + x ];
   for (var prop in x){
     t.push(prop + ' - ' + (typeof x[prop]) + ' - ' +  (x[prop] || 'n/a'));
   }
   alert(t.join('\n'));
 }

// html で: <button onclick="showLoc();">location プロパティを示します</button>

search プロパティを変更することによって、サーバーにデータの文字列を送ります。:

function sendData(dat)
{
  window.location.search = dat;
}

// html で: <button onclick="sendData('Some data');">データ送信</button>

現在の URL に "?Some%20data" を追加したものが、サーバーに送られます（サーバーによって何も動作が引き起こされない場合、変更された search 文字列を URL に付加した状態で現在の文書が再読み込みされます）。

仕様

ブラウザー互換性

[1] In old versions of Internet Explorer 11 on Windows 10 window.location.origin is undefined due to a bug, see https://connect.microsoft.com/IE/feedback/details/1763802/location-origin-is-undefined-in-ie-11-on-windows-10-but-works-on-windows-7.

関連項目

• The interface of the returned value, Location.
• A similar information, but attached to the document, Document.location.
• Manipulating the browser history
• hashchange