Document.location

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

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

Чтобы получить URL как строку, вы можете использовать read-only свойство document.URL.

Если страница находится вне текущего контекста, вернётся null.

Синтаксис

locationObj = document.location
document.location = 'http://www.mozilla.org' // Эквиваленто след.
document.location.href = 'http://www.mozilla.org'

Пример

dump(document.location);
// Выведет строку
// "http://www.example.com/juicybits.html" в консоли

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

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

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

BCD tables only load in the browser

 

 

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

  • Интерфейс возвращаемого значения, Location.
  • Похожая информация, но привязанная к контексту, Window.location