Document: location プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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 オブジェクトをコンソールへ表示

仕様書

Specification
HTML Standard
# the-location-interface

ブラウザーの互換性

BCD tables only load in the browser

関連情報