O método Location.reload()
recarrega a URL atual. Seu unico parâmetro opcional é um Boolean
, 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
, 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 |
---|---|---|
WHATWG HTML Living Standard The definition of 'Location.reload()' in that specification. |
Living Standard | Nenhuma mudança do HTML5. |
HTML5 The definition of 'Location.reload()' in that specification. |
Recommendation | Definição inicial. |
Compatibilidade de Navegadores
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Veja também
- A interface
Location
que o método pertence. - Métodos similares:
Location.assign()
eLocation.replace()
.
Etiquetas do documento e colaboradores
Etiquetas:
Colaboradores desta página:
fcard,
alexrohleder
Última atualização por:
fcard,