- Location
- Свойства
- Методы
- Примеры
- Спецификации
- Совместимость с браузерами
- Смотрите также
- Found a content problem with this page?
- window . location
- Пример
- Как понять
- Как пишется
- Свойства
- Методы
- JavaScript Window Location
- Window Location
- Window Location Href
- Example
- Window Location Hostname
- Example
- Window Location Pathname
- Example
- Window Location Protocol
- Example
- Window Location Port
- Example
- Window Location Assign
- Example
- COLOR PICKER
- Report Error
- Thank You For Helping Us!
Location
Интерфейс Location представляет собой адрес (URL) объекта, с которым он связан. Его модификации отражаются на родительском объекте. Интерфейсы Document и Window имеют подобный Location , к которому можно получить доступ через Document.location и Window.location соответственно.
Свойства
Интерфейс Location не имеет унаследованных свойств, но реализует свойства URLUtils .
DOMString , содержащий URL целиком. При изменении, соответствующий документ переходит на новую страницу.
DOMString , содержащий протокол текущего URL, включая ‘:’ .
DOMString , содержащий хост, а именно имя хоста, ‘:’ и порт.
DOMString , содержащий домен текущего URL.
DOMString , содержащий номер порта текущего URL.
DOMString , содержащий первый ‘/’ после хоста с последующим текстом URL.
DOMString , содержащий ‘?’ с последующими параметрами URL.
DOMString , содержащий ‘#’ с последующим идентификатором.
DOMString , содержащий имя пользователя, указанное перед именем домена.
DOMString , содержащий пароль, указанный перед именем домена.
Возвращает DOMString , содержащий протокол, хост и порт текущего URL.
Методы
Интерфейс Location не имеет унаследованных методов, но реализует методы URLUtils .
Загружает ресурс по URL, указанному в качестве параметра.
Перезагружает ресурс по текущему URL. Единственный опциональный параметр Boolean (en-US) при значении true указывает, что страница должна быть заново загружена с сервера, при значении false страница может быть загружена из кеша.
Заменяет текущий ресурс на новый по URL, указанному в качестве параметра. Отличие от assign() в том, что при использовании replace() текущая страница не будет сохранена в History , и пользователь не сможет использовать кнопку назад, чтобы вернуться к ней.
Возвращает 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
Спецификации
Совместимость с браузерами
BCD tables only load in the browser
Смотрите также
Found a content problem with this page?
This page was last modified on 17 окт. 2022 г. by MDN contributors.
Your blueprint for a better internet.
window . location
location — это объект хранящийся в window , который позволяет получать информацию о текущем адресе страницы и менять его с помощью функций или обновления полей объекта.
Пример
Скопировать ссылку «Пример» Скопировано
С помощью location мы можем получить текущий адрес:
// если выполнить этот скрипт на текущей странице доки в консолиconsole.log(window.location.href)// 'https://doka.guide/js/window-location/'
// если выполнить этот скрипт на текущей странице доки в консоли console.log(window.location.href) // 'https://doka.guide/js/window-location/'
Обновление текущей страницы можно произвести с помощью reload ( ) . Этот метод делает то же самое, что и кнопка «Обновить» в браузере:
window.location.reload()
window.location.reload()
С помощью replace ( ) можно сделать клиентский редирект, это приведёт к мгновенному переходу по адресу, указанному при вызове метода:
window.location.replace('https://doka.guide/')
window.location.replace('https://doka.guide/')
Как понять
Скопировать ссылку «Как понять» Скопировано
Для навигации по сайту мы используем адреса и параметры страницы. window . location содержит набор свойств и методов, чтобы удобно получать адрес и управлять им.
Как пишется
Скопировать ссылку «Как пишется» Скопировано
Свойства
Скопировать ссылку «Свойства» Скопировано
href – полное представление адреса. Можно сказать, что это зеркало того, что находится в адресной строке браузера в данный момент. Если записать значение в это свойство, то произойдёт обновление адреса и редирект на новый адрес.
Остальные свойства — это кусочки location . href . Они нужны, чтобы удобно получать каждый из них отдельно, а не вытаскивать их руками из полной строки адреса.
console.log(window.location.href)// отобразит текущий адресwindow.location.href = 'https://example.com'// сделает переход по указанному адресу
console.log(window.location.href) // отобразит текущий адрес window.location.href = 'https://example.com' // сделает переход по указанному адресу
protocol содержит текущий протокол по которому открыта страница. Чаще всего там будет https и http .
host содержит значение хоста из ссылки. Хост включает в себя название текущего домена и порта.
hostname — частичка с доменом из свойства host , не включает в себя порт.
port — вторая составляющая значения host , содержит только номер порта. Если порт не указан в явном виде, то значением свойства будет пустая строка » .
origin включает в себя путь, начиная с protocol и заканчивая port .
search содержит параметры в формате ключ = значение разделённые & . Если параметров нет, то значением будет пустая строка.
hash — якорная ссылка включая символ # . Она находится в самом конце пути и отвечает за навигацию между размеченными на странице элементами с помощью установки атрибута id на тегах. Эта часть URL не передаётся на сервер. Если параметров нет, то значением будет пустая строка.
window.location.hash = 'в-работе'// проскролит страницу до элемента с `id="в-работе"` если такой присутствует на страницеconsole.log(window.location.hash)// напечатает якорь
window.location.hash = 'в-работе' // проскролит страницу до элемента с `id="в-работе"` если такой присутствует на странице console.log(window.location.hash) // напечатает якорь
pathname – репрезентация текущего пути на сайте. Если текущий урл не содержит путь, то значением будет корневой путь » / » .
Например, значения window . location . pathname в зависимости от адреса:
- https : / / doka . guide / js / window — location / → /js / window — location / .
- https : / / doka . guide → / .
Методы
Скопировать ссылку «Методы» Скопировано
assign ( новый _ путь ) – метод вызывает переход на страницу, переданную в аргументах. После перехода на страницу пользователь может вернуться на страницу, с которой произошёл переход, с помощью браузерной кнопки назад.
replace ( новый _ путь ) аналогичен методу assign ( ) , но адрес страницы с которой был вызван этот метод не будет сохранён в истории браузера. При попытке вернуться назад пользователь будет отправлен на страницу предшествующую той, с которой произошёл переход.
reload ( ) перезагружает текущую страницу.
to String ( ) приводит адрес страницы к строке. Возвращает то же самое значение, что и location . href .
JavaScript Window Location
The window.location object can be used to get the current page address (URL) and to redirect the browser to a new page.
Window Location
The window.location object can be written without the window prefix.
- window.location.href returns the href (URL) of the current page
- window.location.hostname returns the domain name of the web host
- window.location.pathname returns the path and filename of the current page
- window.location.protocol returns the web protocol used (http: or https:)
- window.location.assign() loads a new document
Window Location Href
The window.location.href property returns the URL of the current page.
Example
Display the href (URL) of the current page:
Window Location Hostname
The window.location.hostname property returns the name of the internet host (of the current page).
Example
Display the name of the host:
Window Location Pathname
The window.location.pathname property returns the pathname of the current page.
Example
Display the path name of the current URL:
Window Location Protocol
The window.location.protocol property returns the web protocol of the page.
Example
Window Location Port
The window.location.port property returns the number of the internet host port (of the current page).
Example
Display the name of the host:
Most browsers will not display default port numbers (80 for http and 443 for https)
Window Location Assign
The window.location.assign() method loads a new document.
Example
COLOR PICKER
Report Error
If you want to report an error, or if you want to make a suggestion, do not hesitate to send us an e-mail:
Thank You For Helping Us!
Your message has been sent to W3Schools.
Top Tutorials
Top References
Top Examples
Get Certified
W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookie and privacy policy.