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!

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