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/pt-BR/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

BCD tables only load in the browser

Veja também