Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Location.assign()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

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

js
// Navega para a página do artigo Location.reload
document.location.assign(
  "https://newreal1.mobosoft.fun/pt-BR/docs/Web/API/Location.reload",
);

Especificações

Specification
HTML
# dom-location-assign-dev

Compatibilidade com navegadores

Veja também