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
DOMStringcontendo 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!
| 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()andLocation.reload().