Книга: JavaScript. Подробное руководство, 6-е издание

Location

Location

представляет адрес в броузере и управляет им

Свойство location объектов Window и Document ссылается на объект Location, который представляет веб-адрес («местоположение») текущего документа. Свойство href содержит полный URL-адрес этого документа, а каждое из оставшихся свойств объекта Location описывает фрагмент этого URL-адреса. Эти свойства очень похожи на свойства URL-адреса объекта Link. Когда объект Location используется в строковом контексте, возвращается значение его свойства href. Это означает, что вместо выражения location.href можно использовать просто location.

Кроме того что объект Location представляет текущий URL-адрес, он еще и управляет этим адресом. Если строку, содержащую URL-адрес, присвоить объекту Location или его свойству href, то веб-броузер загрузит документ с указанным URL-адресом и отобразит его. Заставить броузер загрузить новый документ можно также путем изменения части текущего URL-адреса. Например, если установить свойство search, броузер перезагрузит текущий URL-адрес с новой строкой запроса. Если установить свойство hash, броузер не загрузит новый документ, но создаст новую запись в истории посещений. А если свойство hash идентифицирует некоторый фрагмент документа, броузер прокрутит документ так, что указанный элемент окажется в видимой области.

Свойства

Свойства объекта Location ссылаются на различные фрагменты URL-адреса текущего документа. Для каждого из следующих свойств дается пример фрагмента следующего (фиктивного) URL-адреса:

http://www.oreilly.com:1234/catalog/search.html?q=JavaScript&m=10#results

string hash

Содержит якорную часть URL-адреса, включая начальный символ решетки (#), в нашем случае - «#results». Эта часть URL-адреса документа определяет имя якорного элемента внутри документа.

string host

Часть URL-адреса, содержащая имя хоста и порт, например: «http://www.oreilly.соm:1234».

string hostname

Часть URL-адреса, содержащая имя хоста, например: «http://www.oreilly.com».

string href

Полный текст URL-адреса документа, в отличие от других свойств объекта Location, которые определяют только части URL-адреса. Присваивание этому свойству нового URL-адреса приводит к тому, что броузер читает и отображает содержимое нового URL-адреса. Непосредственное присваивание объекту Location устанавливает это свойство, и при использовании объекта Location в строковом контексте возвращается значение этого свойства.

string pathname

Путь в URL-адресе, например: «/catalog/search.html».

string port

Порт в URL-адресе, например: «1234». Обратите внимание, что значением этого свойства является строка, а не число.

string protocol

Протокол в URL-адресе, включая завершающее двоеточие, например: «http:».

string search

Часть URL-адреса, которая содержит строку запроса, включая начальный вопросительный знак, например: «?q=JavaScript&m=10».

Методы

void assign(string url)

Загружает и отображает содержимое адреса url, как если бы значение url было присвоено свойству href.

void reload()

Повторно загружает текущий документ.

void replace(string url)

Загружает и отображает содержимое адреса url, замещая текущий документ в истории посещений, вследствие чего щелчок на кнопке Back броузера не вернет его к предыдущему документу.

Оглавление книги