Расположение
Базовая Широко доступна *
Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Интерфейс Location представляет расположение (URL) объекта, к которому он привязан. Изменения, внесенные в него, отражаются на связанном объекте. Как интерфейс Document, так и интерфейс Window имеют такой связанный Location, доступный через Document.location и Window.location соответственно.
Структура Location
Наведите курсор на сегменты URL ниже, чтобы увидеть их значение:
Свойства экземпляра
-
Location.ancestorOriginsТолько для чтения -
Статический
DOMStringList, содержащий в обратном порядке источники всех родительских контекстов просмотра документа, связанного с данным объектомLocation. Location.href-
Строковая функция, возвращающая всю строку URL. При изменении связанный документ переходит на новую страницу. Его можно установить из источника, отличного от связанного документа.
Location.protocol-
Строка, содержащая схему протокола URL, включая конечный
':'. Location.host-
Строка, содержащая хост, то есть имя хоста,
':', и порт URL. Location.hostname-
Строка, содержащая домен URL.
Location.port-
Строка, содержащая номер порта URL.
Location.pathname-
Строка, содержащая начальный
'/'и путь URL, не включая строку запроса или фрагмент. Location.search-
Строка, содержащая
'?'и параметры или "строку запроса" URL. Современные браузеры предоставляютURLSearchParamsиURL.searchParamsдля удобного извлечения параметров из строки запроса. Location.hash-
Строка, содержащая
'#'и идентификатор фрагмента URL. -
Location.originТолько для чтения -
Возвращает строку, содержащую каноническую форму источника конкретного расположения.
Методы экземпляра
Location.assign()-
Загружает ресурс по предоставленному в параметре URL.
Location.reload()-
Перезагружает текущий URL, как кнопка «Обновить».
Location.replace()-
Заменяет текущий ресурс ресурсом по предоставленному URL (перенаправляет на предоставленный URL). Разница с методом
assign()и установкой свойстваhrefзаключается в том, что после использованияreplace()текущая страница не сохранится в истории сессииHistory, что означает, что пользователь не сможет вернуться к ней с помощью кнопки «Назад». Location.toString()-
Возвращает строку, содержащую весь URL. Это синоним для
Location.href, хотя его нельзя использовать для изменения значения.
Примеры
// location: https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container
const loc = document.location;
console.log(loc.href); // https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container
console.log(loc.protocol); // https:
console.log(loc.host); // developer.mozilla.org:8080
console.log(loc.hostname); // developer.mozilla.org
console.log(loc.port); // 8080
console.log(loc.pathname); // /en-US/search
console.log(loc.search); // ?q=URL
console.log(loc.hash); // #search-results-close-container
console.log(loc.origin); // https://developer.mozilla.org:8080
location.assign("http://another.site"); // load another page
Спецификации
| Спецификация |
|---|
| HTML # the-location-interface |
Совместимость браузеров
| Настольный | Мобильный | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
Location |
1 | 12 | 1 | 3 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | ≤37 |
ancestorOrigins |
20 | 79 | No | 15 | 6 | 25 | No | 14 | 6 | 1.5 | 4.4 |
assign |
1 | 12 | 1 | 3 | 3 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 |
hash |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
host |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
hostname |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
href |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
origin |
8 | 12 | 21Before Firefox 49, results for URL using the blob scheme incorrectly returned null. |
15 | 5.1 | 18 | 21Before Firefox for Android 49, results for URL using the blob scheme incorrectly returned null. |
14 | 5 | 1.0 | 3 |
pathname |
1 | 12 | 1Before Firefox 53, thepathname property returned wrong parts of the URL. For example, for a URL of https://z.com/x?a=true&b=false, pathname would return "/x?a=true&b=false" rather than "/x". |
≤12.1 | 1 | 18 | 4Before Firefox for Android 53, thepathname property returned wrong parts of the URL. For example, for a URL of https://z.com/x?a=true&b=false, pathname would return "/x?a=true&b=false" rather than "/x". |
≤12.1 | 1 | 1.0 | 4.4 |
port |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
protocol |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
reload |
1 | 12Before Edge 79, if a page added to Trusted Sites contains a cross-origin iframe, then callingreload() from within the iframe reloads the trusted page (in other words, the top page reloads, not the iframe). |
1 | 3 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 |
replace |
1 | 12 | 1 | 3 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 |
search |
1 | 12 | 1Before Firefox 53, thesearch property returned wrong parts of the URL. For example, for a URL of https://z.com/x?a=true&b=false, search would return "", rather than "?a=true&b=false". |
≤12.1 | 1 | 18 | 4Before Firefox for Android 53, thesearch property returned wrong parts of the URL. For example, for a URL of https://z.com/x?a=true&b=false, search would return "", rather than "?a=true&b=false". |
≤12.1 | 1 | 1.0 | 4.4 |
toString |
52 | 12 | 22 | 39 | 1 | 52 | 22 | 41 | 1 | 6.0 | 52 |
См. также
- Два свойства
Location:Window.locationиDocument.location. - Интерфейсы для работы с URL:
URLиURLSearchParams.
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Location
