Location.assign()
O método Location.assign()
faz com que o navegador carregue o documento na URL especificada e a exiba na janela atual.
Se a tatefa não poder ser executada por alguma violação de segurança, uma DOMException
do tipo SECURITY_ERROR
será lançada. Isso acontece se a origem do script chamador do método for diferente da origem da página originalmente descrita no objeto Location
, geralmente quando o script está hospedado em um dominio diferente.
Se a URL especificada for inválida, uma DOMException
do tipo SYNTAX_ERROR
será lançada.
Sintaxe
location.assign(url);
Parâmetros
- url
-
É uma
DOMString
contendo a URL da página destino.
Exemplos
// Navega para a página do artigo Location.reload
document.location.assign('https://developer.mozilla.org/pt-BR/docs/Web/API/Location.reload');
Especificações
Especificação | Status | Comentários |
---|---|---|
HTML Living Standard The definition of 'Location.assign()' in that specification. |
Padrão em tempo real | Sem alterações no HTML5. |
HTML5 The definition of 'Location.assign()' in that specification. |
Recomendação | Definição inicial. |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- A interface
Location
. - Métodos Similares:
Location.replace()
(en-US) andLocation.reload()
.