Location.reload()

Метод Location.reload() перезагружает ресурс из текущего URL. Единственный опциональный параметр Boolean, при значении true указывает, что страница должна быть перезагружена с сервера. Иначе браузер может загрузить страницу из кэша.

Если условия вызова метода не удовлетворяют требованиям безопасности, выбрасывается DOMException с типом SECURITY_ERROR. Это случается, если домен скрипта, вызывающего метод, не совпадает с доменом страницы, изначально содержащимся в Location.

Синтаксис

object.reload(forcedReload);

Параметры

forcedReload Необязательный
Флаг Boolean, при значении true указывает, что страница должна быть перезагружена с сервера. Если установлен в false или не указан, браузер может загрузить страницу из кэша.

Флаг forcedReload изменяет то, как браузеры Mozilla обрабатывают позицию прокрутки пользователя. Обычно reload() восстанавливает значение, но в принудительный режим может вернуть прокрутку к верху страницы, как если window.scrollY === 0.

Примеры

// Перезагрузить текущую страницу, без использования кэша
document.location.reload(true);

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

Спецификация Статус Комментарий
HTML Living Standard
Определение 'Location.reload()' в этой спецификации.
Живой стандарт Без изменений относительно HTML5.
HTML5
Определение 'Location.reload()' в этой спецификации.
Рекомендация Изначальное определение.

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
reloadChrome Полная поддержка 1Edge Полная поддержка 12
Замечания
Полная поддержка 12
Замечания
Замечания In EdgeHTML versions of Edge, if a page added to Trusted Sites contains a cross-origin iframe, then calling reload() from within the iframe reloads the trusted page (in other words, the top page reloads, not the iframe). This behavior was fixed in Edge 79.
Firefox Полная поддержка 1IE Полная поддержка 5.5
Замечания
Полная поддержка 5.5
Замечания
Замечания If a page added to Trusted Sites contains a cross-origin iframe, then calling reload() from within the iframe reloads the trusted page (in other words, the top page reloads, not the iframe).
Opera Полная поддержка 3Safari Полная поддержка 1WebView Android Полная поддержка 1Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка 10.1Safari iOS Полная поддержка 1Samsung Internet Android Полная поддержка 1.0

Легенда

Полная поддержка  
Полная поддержка
Смотрите замечания реализации.
Смотрите замечания реализации.

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