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.

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
# dom-location-assign-dev

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
assign

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
User must explicitly enable this feature.

Veja também