Document.location
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.
A propriedade, de apenas leitura, Document.location
retorna um objeto Location
, que contém informações sobre a URL do documento e provém métodos para mudar a URL e carregar outra URL.
Embora Document.location
seja um objeto Location de apenas leitura
, você pode atribuir um DOMString
para ele. Isso significa que você pode trabalhar com document.location, na maioria dos casos, como se fosse uma string: document.location = 'http://www.example.com'
é um sinônimo de document.location.href = 'http://www.example.com'
.
Para recuperar somente a URL como uma string, a propriedade de apenas leitura document.URL
pode ser utilizada.
Se o documento atual não estiver no contexto de navegação, o valor retornado será null
.
Sintaxe
locationObj = document.location document.location = 'http://www.mozilla.org' // Equivalente a document.location.href = 'http://www.mozilla.org'
Exemplo
dump(document.location);
// Imprime uma string como
// "http://www.example.com/juicybits.html" to the console
Especificações
Specification |
---|
HTML Standard # the-location-interface |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- O valor da interface de retorno,
Location
. - Uma informação similar, mas anexada ao browsing context,
Window.location
.