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.

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)

Resumo

A interface Location representa a localização do objeto a qual ele está associado. Mudanças feitas na interface serão refletidas nos objetos relacionados a ela. Tanto a interface Document, como a interface Window , têm este vínculo com a inteface Location, acessível via Document.location e Window.location respectivamente.

Propriedades

A inteface Location não herda nenhuma propriedade, mas implementa as propriedades de URLUtils.

URLUtils.href

É uma DOMString que contém toda URL.

URLUtils.protocol

É uma DOMString que contém o esquema de protocolo da URL, incluindo o final ':'.

URLUtils.host

É uma DOMString que contém o host, que é o hostname seguido de ':' e a port da URL.

URLUtils.hostname

É uma DOMString que contém o domínio da URL.

URLUtils.port

É uma DOMString que contém o número da porta da URL.

URLUtils.pathname

É uma DOMString que contém '/', como caractere inicial, seguido do caminho da URL.

URLUtils.search

É uma DOMString que contém um '?' seguido dos parâmetros da URL.

URLUtils.hash

É uma DOMString que contém um '#' seguido do identificador de fragmento da URL.

URLUtils.username

É uma DOMString que contém o nome de usuário especificado antes do nome de domínio.

URLUtils.password

É uma DOMString que contém a senha especificada antes do nome de domínio.

URLUtils.origin Somente leitura

Retorna uma DOMString que contém a forma canônica da origem do local especificado.

Métodos

A inteface Location não herda nenhum método, mas implementa os métodos de URLUtils

Location.assign()

Carrega o recurso na URL fornecida como parâmetro.

Location.reload()

Recarrega o recurso a partir da URL atual. Seu único parâmetro opcional é um Boolean, que, quando verdadeiro (true), faz com que a página sempre seja recarregada a partir do servidor. Se for falso (false) ou não especificado, o navegador pode recarregar a página a partir de seu cache.

Location.replace()

Substitui o recurso atual pelo recurso presente na URL fornecida. A diferença entre o método assign() é que após usar replace() a página atual não será salva na sessão History, ou seja, o usuário não será capaz de usar o botão voltar para navegar até a página.

URLUtils.toString()

Retorna uma DOMString que contém toda URL. O método é um sinônimo para URLUtils.href, embora não possa ser usado para modificar o valor.

Especificações

Specification
HTML Standard
# the-location-interface

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também