Location

Интерфейс Location представляет собой адрес (URL) объекта, с которым он связан. Его модификации отражаются на родительском объекте. Интерфейсы Document и Window имеют подобный Location, к которому можно получить доступ через Document.location и Window.location соответственно.

Свойства

Интерфейс Location не имеет унаследованных свойств, но реализует свойства URLUtils.

Location.href
DOMString, содержащий URL целиком. При изменении, соответствующий документ переходит на новую страницу.
Location.protocol
DOMString, содержащий протокол текущего URL, включая ':'.
Location.host
DOMString, содержащий хост, а именно имя хоста, ':' и порт.
Location.hostname
DOMString, содержащий домен текущего URL.
Location.port
DOMString, содержащий номер порта текущего URL.
Location.pathname
DOMString, содержащий первый '/' после хоста с последующим текстом URL.
Location.search
DOMString, содержащий '?' с последующими параметрами URL.
Location.hash
DOMString, содержащий '#' с последующим идентификатором.
Location.username
DOMString, содержащий имя пользователя, указанное перед именем домена.
Location.password
DOMString, содержащий пароль, указанный перед именем домена.
Location.origin Только для чтения
Возвращает DOMString, содержащий протокол, хост и порт текущего URL.

Методы

Интерфейс Location не имеет унаследованных методов, но реализует методы URLUtils.

Location.assign()
Загружает ресурс по URL, указанному в качестве параметра.
Location.reload()
Перезагружает ресурс по текущему URL. Единственный опциональный параметр Boolean при значении true указывает, что страница должна быть заново загружена с сервера, при значении false страница может быть загружена из кэша.
Location.replace()
Заменяет текущий ресурс на новый по URL, указанному в качестве параметра. Отличие от assign() в том, что при использовании replace() текущая страница не будет сохранена в History, и пользователь не сможет использовать кнопку назад, чтобы вернуться к ней.
Location.toString()
Возвращает DOMString, содержащий URL целиком. Это синоним URLUtils.href, однако он не может использоваться для изменения значения.

Примеры

// Этот пример создает ссылку и использует ее свойство href
// Корректная альтернатива - использовать document.location или window.location текущего URL
var url = document.createElement('a');
url.href = 'https://developer.mozilla.org/en-US/search?q=URL#search-results-close-container';
console.log(url.href);      // https://developer.mozilla.org/en-US/search?q=URL#search-results-close-container
console.log(url.protocol);  // https:
console.log(url.host);      // developer.mozilla.org
console.log(url.hostname);  // developer.mozilla.org
console.log(url.port);      // (пустой - https подразумевает порт 443)
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

Спецификации

Спецификация Статус Комментарий
HTML Living Standard
Определение 'Location' в этой спецификации.		 Живой стандарт Без изменений относительно HTML5.
HTML5
Определение 'Location' в этой спецификации.		 Рекомендация Изначальное определение.

Совместимость с браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Базовая поддержка (Да) (Да) (Да) (Да) (Да)
origin в Windows.location ? 21 (21) ? ? ?
origin во всех объектах location (кроме Workers, где используется WorkerLocation) ? 26 (26) ? ? ?
username и password ? 26 (26) ? ? ?
Возможность Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Базовая поддержка (Да) (Да) (Да) (Да) (Да)
origin в Windows.location ? 21.0 (21) ? ? ?
origin во всех объектах location (кроме Workers, где используется WorkerLocation) ? 26.0 (26) ? ? ?
username и password ? 26.0 (26) ? ? ?

Смотрите также