3.1 KiB
title | localeTitle |
---|---|
Location Object | Objeto de localização |
Objeto de localização
O objeto "Location" fornece uma API (Application Programming Interface) que permite a recuperação de um URL, a configuração de um URL ou o acesso a partes de um URL. Já está implementado por padrão nos objetos Window e Document. Nota: Não existe um padrão público que se aplique ao objeto de localização, mas todos os principais navegadores o suportam.
Propriedades do objeto de localização
| Propriedade | Descrição | | ---------- | -------------------------------------- ------------------- | | hash | Define ou retorna a parte da âncora (#) de um URL | | host | Define ou retorna o nome do host e o número da porta de um URL | | hostname | Define ou retorna o nome do host de um URL | | href | Define ou retorna o URL inteiro | | origem | Retorna o protocolo, o nome do host e o número da porta de um URL | | nome do caminho | Define ou retorna o nome do caminho de um URL | | porta | Define ou retorna o número da porta de um URL | | protocolo | Define ou retorna o protocolo de um URL | | pesquisa | Define ou retorna a parte de querystring de um URL |
Métodos de objeto de localização
| Método | Descrição | | ----------- | ------------------------------------- --------- | | assign () | Carrega um novo documento | | recarregar () | Recarrega o documento atual | | replace () | Substitui o documento atual por um novo |
Exemplos
Os objetos de localização são acessíveis por:
console.log(window.location);
// > https://guide.freecodecamp.org/javascript/location-object
console.log(document.location);
// > https://guide.freecodecamp.org/javascript/location-object
Você também pode definir o objeto Location de um elemento HTML <a>
ou um elemento HTML <area>
programaticamente com JavaScript.
var anchor = document.createElement('a');
anchor.url = "https://guide.freecodecamp.org/javascript/location-object";
Quando você tiver um objeto com um conjunto de URLs (incluindo a janela), a API local permite acessar partes do URL.
console.log(anchor.protocol);
// > https:
console.log(anchor.host);
// > guide.freecodecamp.org (includes port number if applicable. Example: guide.freecodecamp.org:8080)
Outras propriedades de "Localização" que você pode acessar são:
anchor.hostname
- guide.freecodecamp.organchor.port
- 8080anchor.pathname
- / javascript / location-objectanchor.origin
- https://developer.mozilla.org
Se o seu URL contiver parâmetros ou hashes, você poderá acessá-los assim:
// If your URL is https://guide.freecodecamp.org/javascript?param=location#other-properties
console.log(window.location.search);
// > "?param=location"
console.log(document.location.hash);
// > "#other-properties"