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/en-US/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
Estamos convertendo nossos dados de compatibilidade para o formato JSON.
Esta tabela de compatibilidade ainda usa o formato antigo,
pois ainda não convertemos os dados que ela contém.
Descubra como você pode ajudar! (en-US)
Característica | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Suporte Básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Característica | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Suporte Básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Veja também
- A interface
Location
. - Métodos Similares:
Location.replace()
(en-US) andLocation.reload()
.