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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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

Etiquetas do documento e colaboradores

Colaboradores desta página: Rhubenni_Telesco
Última atualização por: Rhubenni_Telesco,