Интерфейс 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) | ? | ? | ? |
Смотрите также
- Два метода, создающих подобные объекты:
Window.location
иDocument.location
. - Интерфейсы, относящиеся к URL:
URL
,URLSearchParams
иHTMLHyperlinkElementUtils