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.

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

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
# the-location-interface

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
Location
ancestorOrigins
assign
hash
host
hostname
href
origin
pathname
port
protocol
reload
replace
search
toString

Legend

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

Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.
User must explicitly enable this feature.

Veja também