Location

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.

* Some parts of this feature may have varying levels of support.

Resumo

A interfaceLocation 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 interfaceDocument, como a interfaceWindow , têm este vínculo com a inteface Location, acessível viaDocument.location eWindow.location respectivamente.

Propriedades

A intefaceLocation não herda nenhuma propriedade, mas implementa as propriedades deURLUtils.

URLUtils.href: É umaDOMString que contém toda URL.
URLUtils.protocol: É umaDOMString que contém o esquema de protocolo da URL, incluindo o final ':'.
URLUtils.host: É umaDOMString que contém ohost, que é ohostname seguido de ':' e aport da URL.
URLUtils.hostname: É umaDOMString que contém o domínio da URL.
URLUtils.port: É umaDOMString que contém o número da porta da URL.
URLUtils.pathname: É umaDOMString que contém'/', como caractere inicial, seguido do caminho da URL.
URLUtils.search: É umaDOMString que contém um'?' seguido dos parâmetros da URL.
URLUtils.hash: É umaDOMString que contém um'#' seguido do identificador de fragmento da URL.
URLUtils.username: É umaDOMString que contém o nome de usuário especificado antes do nome de domínio.
URLUtils.password: É umaDOMString que contém a senha especificada antes do nome de domínio.
URLUtils.originSomente leitura: Retorna umaDOMString que contém a forma canônica da origem do local especificado.

Métodos

A intefaceLocation não herda nenhum método, mas implementa os métodos deURLUtils

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 é umBoolean, 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étodoassign() é que após usarreplace() a página atual não será salva na sessãoHistory, ou seja, o usuário não será capaz de usar o botãovoltar para navegar até a página.
URLUtils.toString(): Retorna umaDOMString que contém toda URL. O método é um sinônimo paraURLUtils.href, embora não possa ser usado para modificar o valor.