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