Документ: свойство location

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

То свойство Document.location возвращает Location объект, содержащий информацию об URL документа и предоставляющий методы для изменения этого URL и загрузки другого URL.

Хотя Document.location является только для чтения Location объектом, вы также можете присвоить ему строку. Это означает, что в большинстве случаев вы можете работать с document.location так, как будто это строка: document.location = 'http://www.example.com' является синонимом document.location.href = 'http://www.example.com'. Если вы присвоите ему другую строку, браузер загрузит веб-сайт, который вы назначили.

Для получения только URL в виде строки также можно использовать свойство только для чтения document.URL.

Если текущий документ не находится в контексте просмотра, возвращаемое значение равно null.

Значение

Объект Location.

Примеры

console.log(document.location);
// Prints a Location object to the console

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

Спецификация
HTML # the-location-interface

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`location`	1	12	1	3	4 1–4 Поддерживается только для `HTMLDocument`, а не для всех `Document` объектов.	18	4	10.1	3.2 1–3.2 Поддерживается только для `HTMLDocument`, а не для всех `Document` объектов.	1.0	4.4

См. также

Интерфейс возвращаемого значения, Location
Аналогичная информация, но связанная с контекстом просмотра, Window.location

© 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/Document/location