Location.reload()
O método Location.reload()
recarrega a URL atual. Seu unico parâmetro opcional é um Boolean
(en-US), que, quando true
, faz com que a página sempre seja recarregada do servidor. Se ele é false
ou não estiver especificado, o navegador pode carregar ela do cache.
Caso não seja possível recarregar por questões de violação de segurança, uma DOMException
do tipo SECURITY_ERROR
é jogada. Isso acontece se a origem do script que chama o método é diferente da origem da página originalmente descrita pelo objeto Location
, usualmente quando o script é hosteado em um domínio diferente.
Sintaxe
object.reload(forcedReload);
Parametros
- forcedReload Optional
-
É uma flag
Boolean
(en-US), que quandotrue
, faz com que a página sempre seja recarregada do servidor, se éfalse
ou não for definido, o navegador pode recarregar a página do cache.
Exemplos
// Recarrega a página atual sem usar o cache
document.location.reload(true);
Especificações
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'Location.reload()' in that specification. |
Padrão em tempo real | Nenhuma mudança do HTML5. |
HTML5 The definition of 'Location.reload()' in that specification. |
Recomendação | Definição inicial. |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- A interface
Location
que o método pertence. - Métodos similares:
Location.assign()
eLocation.replace()
(en-US).