Document: location プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
Document.location は読み取り専用のプロパティで、この文書の URL に関する情報を持った Location オブジェクトを返します。これはその URL を変更したり他の URL を読み込んだりするためのメソッドも提供しています。
Document.location は読み取り専用の Location オブジェクトですが、文字列を代入することができます。つまり、 document.location が文字列であるかのように扱うことができます。 document.location = 'http://www.example.com' は document.location.href = 'http://www.example.com' の別名です。他の文字列を代入すると、ブラウザーは代入されたウェブサイトを読み込みます。
URL を文字列として受け取るだけであれば、読み取り専用の document.URL プロパティも利用することができます。
現在の文書が閲覧コンテキスト内にない場合、返値は null となります。
値
Location オブジェクトです。
例
js
console.log(document.location);
// Location オブジェクトをコンソールへ表示
仕様書
| 仕様書 |
|---|
| HTML> # the-location-interface> |
ブラウザーの互換性
関連情報
- 返値のインターフェイスである
Location - 同様の情報で閲覧コンテキストに結びつけられている
Window.location