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 July 2015.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/pt-br/web/api/html_dom_api/index.md)

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://developer.mozilla.org/pt-BR/docs/Web/API/Location.reload",
);

Especificações

Specification
HTML Standard
# dom-location-assign-dev

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também