From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/pt-br/web/api/location/assign/index.html | 120 ++++++++++++++++ files/pt-br/web/api/location/index.html | 184 +++++++++++++++++++++++++ files/pt-br/web/api/location/reload/index.html | 114 +++++++++++++++ files/pt-br/web/api/location/search/index.html | 55 ++++++++ 4 files changed, 473 insertions(+) create mode 100644 files/pt-br/web/api/location/assign/index.html create mode 100644 files/pt-br/web/api/location/index.html create mode 100644 files/pt-br/web/api/location/reload/index.html create mode 100644 files/pt-br/web/api/location/search/index.html (limited to 'files/pt-br/web/api/location') diff --git a/files/pt-br/web/api/location/assign/index.html b/files/pt-br/web/api/location/assign/index.html new file mode 100644 index 0000000000..e1a1cf8609 --- /dev/null +++ b/files/pt-br/web/api/location/assign/index.html @@ -0,0 +1,120 @@ +--- +title: Location.assign() +slug: Web/API/Location/assign +tags: + - API + - HTML-DOM + - Location + - Referencia + - metodo +translation_of: Web/API/Location/assign +--- +

{{ APIRef("HTML DOM") }}

+ +

O método Location.assign() faz com que o navegador carregue o documento na URL especificada e a exiba na janela atual.

+ +

Se a tatefa não poder ser executada por alguma violação de segurança, uma {{domxref("DOMException")}} do tipo SECURITY_ERROR será lançada. Isso acontece se a origem do script chamador do método for diferente da origem da página originalmente descrita no objeto {{domxref("Location")}}, geralmente quando o script está hospedado em um dominio diferente.

+ +

Se a URL especificada for inválida, uma {{domxref("DOMException")}} do tipo SYNTAX_ERROR será lançada.

+ +

Sintaxe

+ +
location.assign(url);
+
+ +

Parâmetros

+ +
+
url
+
É uma {{domxref("DOMString")}} contendo a URL da página destino.
+
+ +

Exemplos

+ +
// Navega para a página do artigo Location.reload
+document.location.assign('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentários
{{SpecName('HTML WHATWG', "history.html#dom-location-assign", "Location.assign()")}}{{Spec2('HTML WHATWG')}}Sem alterações  no {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#dom-location-assign", "Location.assign()")}}{{Spec2('HTML5 W3C')}}Definição inicial.
+ +

Compatibilidade com Navegadores

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte Básico{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte Básico{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

Veja também

+ + diff --git a/files/pt-br/web/api/location/index.html b/files/pt-br/web/api/location/index.html new file mode 100644 index 0000000000..027a8564ec --- /dev/null +++ b/files/pt-br/web/api/location/index.html @@ -0,0 +1,184 @@ +--- +title: Location +slug: Web/API/Location +tags: + - API + - Interface + - Location +translation_of: Web/API/Location +--- +

{{APIRef("HTML DOM")}}

+ +

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 {{domxref("Document")}}, como a interface {{domxref("Window")}} , têm este vínculo com a inteface Location, acessível via {{domxref("Document.location")}} e {{domxref("Window.location")}} respectivamente.

+ +

Propriedades

+ +

A inteface Location não herda nenhuma propriedade, mas implementa as propriedades de {{domxref("URLUtils")}}.

+ +
+
{{domxref("URLUtils.href")}}
+
É uma {{domxref("DOMString")}} que contém toda URL.
+
{{domxref("URLUtils.protocol")}}
+
É uma {{domxref("DOMString")}} que contém o esquema de protocolo da URL, incluindo o final ':'.
+
{{domxref("URLUtils.host")}}
+
É uma {{domxref("DOMString")}} que contém o host, que é o hostname seguido de ':' e a port da URL.
+
{{domxref("URLUtils.hostname")}}
+
É uma {{domxref("DOMString")}} que contém o domínio da URL.
+
{{domxref("URLUtils.port")}}
+
É uma {{domxref("DOMString")}} que contém o número da porta da URL.
+
{{domxref("URLUtils.pathname")}}
+
É uma {{domxref("DOMString")}} que contém '/', como caractere inicial, seguido do caminho da URL.
+
{{domxref("URLUtils.search")}}
+
É uma {{domxref("DOMString")}} que contém um '?' seguido dos parâmetros da URL.
+
{{domxref("URLUtils.hash")}}
+
É uma {{domxref("DOMString")}} que contém um '#' seguido do identificador de fragmento da URL.
+
{{domxref("URLUtils.username")}}
+
É uma {{domxref("DOMString")}} que contém o nome de usuário especificado antes do nome de domínio.
+
{{domxref("URLUtils.password")}}
+
É uma {{domxref("DOMString")}} que contém a senha especificada antes do nome de domínio.
+
{{domxref("URLUtils.origin")}} {{readOnlyInline}}
+
Retorna uma {{domxref("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 {{domxref("URLUtils")}}.

+ +
+
{{domxref("Location.assign()")}}
+
Carrega o recurso na URL fornecida como parâmetro.
+
{{domxref("Location.reload()")}}
+
Recarrega o recurso a partir da URL atual. Seu único parâmetro opcional é um {{domxref("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.
+
{{domxref("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  {{domxref("History")}}, ou seja, o usuário não será capaz de usar o botão voltar para navegar até a página.
+
{{domxref("URLUtils.toString()")}}
+
Retorna uma {{domxref("DOMString")}} que contém toda URL. O método é um sinônimo para {{domxref("URLUtils.href")}}, embora não possa ser usado para modificar o valor.
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('HTML WHATWG', "history.html#the-location-interface", "Location")}}{{Spec2('HTML WHATWG')}}Nenhuma mudança a partir {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Location")}}{{Spec2('HTML5 W3C')}}Definição inicial.
+ +

Compatibilidade entre Navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FuncionalidadeChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Suporte Básico{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
origin em Windows.location{{CompatUnknown}}{{CompatGeckoDesktop("21")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
origin em todos objetos location (mas nos objetos Workers, que usam {{domxref("WorkerLocation")}}){{CompatUnknown}}{{CompatGeckoDesktop("26")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
username e password{{CompatUnknown}}{{CompatGeckoDesktop("26")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FuncionalidadeAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Suporte Básico{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
origin on Windows.location{{CompatUnknown}}{{CompatGeckoMobile("21")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
origin on all location objects (mas nos objetos Workers, que usam {{domxref("WorkerLocation")}}){{CompatUnknown}}{{CompatGeckoMobile("26")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
username e password{{CompatUnknown}}{{CompatGeckoMobile("26")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Veja também

+ + diff --git a/files/pt-br/web/api/location/reload/index.html b/files/pt-br/web/api/location/reload/index.html new file mode 100644 index 0000000000..24d990bbe8 --- /dev/null +++ b/files/pt-br/web/api/location/reload/index.html @@ -0,0 +1,114 @@ +--- +title: Location.reload() +slug: Web/API/Location/reload +tags: + - API + - HTML-DOM + - Localização + - Referencia + - metodo +translation_of: Web/API/Location/reload +--- +

{{ APIRef("HTML DOM") }}

+ +

O método Location.reload() recarrega a URL atual. Seu unico parâmetro opcional é um {{domxref("Boolean")}}, que, quando true, faz com que a página sempre seja recarregada do servidor. Se ele é false ou não estiver especificado, o navegador pode carregar ela do cache.

+ +

Caso não seja possível recarregar por questões de violação de segurança, uma {{domxref("DOMException")}} do tipo SECURITY_ERROR é jogada. Isso acontece se a origem do script que chama o método é diferente da origem da página originalmente descrita pelo objeto {{domxref("Location")}}, usualmente quando o script é hosteado em um domínio diferente.

+ +

Sintaxe

+ +
object.reload(forcedReload);
+
+ +

Parametros

+ +
+
forcedReload {{optional_inline}}
+
É uma flag {{domxref("Boolean")}}, que quando true, faz com que a página sempre seja recarregada do servidor, se é false ou não for definido, o navegador pode recarregar a página do cache.
+
+ +

Exemplos

+ +
// Recarrega a página atual sem usar o cache
+document.location.reload(true);
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', "history.html#dom-location-reload", "Location.reload()")}}{{Spec2('HTML WHATWG')}}Nenhuma mudança do  {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#dom-location-reload", "Location.reload()")}}{{Spec2('HTML5 W3C')}}Definição inicial.
+ +

Compatibilidade de Navegadores

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

Veja também

+ + diff --git a/files/pt-br/web/api/location/search/index.html b/files/pt-br/web/api/location/search/index.html new file mode 100644 index 0000000000..6cc17724d5 --- /dev/null +++ b/files/pt-br/web/api/location/search/index.html @@ -0,0 +1,55 @@ +--- +title: 'Location: search' +slug: Web/API/Location/search +tags: + - API + - Location + - Propriedade + - Search +translation_of: Web/API/Location/search +--- +
{{ApiRef("Location")}}
+ +

A propriedade search da interface {{domxref("Location")}} é um texto de busca, também chamado de query string ou querystring; isso é, uma {{domxref("USVString")}} contendo um '?' seguido pelos parâmetros da URL.

+ +

Os navegadores modernos fornecem o URLSearchParams e o URL.searchParams para facilitar a análise dos parâmetros da querystring.

+ +

Sintaxe

+ +
string = object.search;
+object.search = string;
+
+ +

Exemplos

+ +
// Seleciona o elemento <a id="myAnchor" href="https://developer.mozilla.org/en-US/docs/Location.search?q=123">
+var anchor = document.getElementById("myAnchor");
+var queryString = anchor.search; // Retorna:'?q=123'
+
+// Análise adicional:
+let params = new URLSearchParams(queryString);
+let q = parseInt(params.get("q")); // é o número 123
+
+ +

Especificação

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('HTML WHATWG', '#dom-location-search', 'search')}}{{Spec2('HTML WHATWG')}}Definição inicial.
+ +

Compatibilidade do navegador

+ + + +

{{Compat("api.Location.search")}}

-- cgit v1.2.3-54-g00ecf