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-pt/web/api/urlsearchparams/index.html | 207 +++++++++++++++++++++++++ 1 file changed, 207 insertions(+) create mode 100644 files/pt-pt/web/api/urlsearchparams/index.html (limited to 'files/pt-pt/web/api/urlsearchparams') diff --git a/files/pt-pt/web/api/urlsearchparams/index.html b/files/pt-pt/web/api/urlsearchparams/index.html new file mode 100644 index 0000000000..3cbed3eea5 --- /dev/null +++ b/files/pt-pt/web/api/urlsearchparams/index.html @@ -0,0 +1,207 @@ +--- +title: URLSearchParams +slug: Web/API/URLSearchParams +translation_of: Web/API/URLSearchParams +--- +

{{ApiRef("URL API")}}

+ +

O interface URLSearchParams define métodos que permitem trabalhar com uma query string de um URL.

+ +

Um objeto que implemente URLSearchParams pode ser utilizado diretamente numa estrutura {{jsxref("Statements/for...of", "for...of")}}, em vez de {{domxref('URLSearchParams.entries()', 'entries()')}}: for (var p of mySearchParams) é equivalente a for (var p of mySearchParams.entries()).

+ +

Construtor

+ +
+
{{domxref("URLSearchParams.URLSearchParams", 'URLSearchParams()')}}
+
O construtor devolve um objeto URLSearchParams.
+
+ +

Propriedades

+ +

Este interface não herda nehuma propriedade.

+ +

Métodos

+ +

Este interface não herda nehum método.

+ +
+
{{domxref("URLSearchParams.append()")}}
+
Adiciona um par chave/valor como um novo parâmetro de pesquisa.
+
{{domxref("URLSearchParams.delete()")}}
+
Elimina o parâmetro de pesquisa e o seu valor, da lista de parâmetros de pesquisa.
+
{{domxref("URLSearchParams.entries()")}}
+
Devolve um {{jsxref("Iteration_protocols","iterator")}} que permite iterar pelos pares chave/valor neste objeto.
+
{{domxref("URLSearchParams.get()")}}
+
Devolve o primeiro valor relacionado com o parâmetro de pesquisa enviado.
+
{{domxref("URLSearchParams.getAll()")}}
+
Devolve todos os valores relacionados com um determinado parâmetro de pesquisa.
+
{{domxref("URLSearchParams.has()")}}
+
Devolve um {{jsxref("Boolean")}} , indicando de um determinado parâmetro de pesquisa existe.
+
{{domxref("URLSearchParams.keys()")}}
+
Devolve um {{jsxref("Iteration_protocols", "iterator")}} permitindo interar pelas chaves de todos os pares chave/valor existentes no objeto.
+
{{domxref("URLSearchParams.set()")}}
+
Define o valor associado a um parâmetro de pesquisa. Elimina outros valores se existirem.
+
{{domxref("URLSearchParams.toString()")}}
+
Devolve uma string com os parâmetros válidos para serem utilizados num URL.
+
{{domxref("URLSearchParams.values()")}}
+
Devolve um {{jsxref("Iteration_protocols", "iterator")}} que permite iterar por todos os valores dos pares chave/valor existentes neste objeto.
+
+ +

Exemplo

+ +
var paramsString = "q=URLUtils.searchParams&topic=api"
+var searchParams = new URLSearchParams(paramsString);
+
+//Iterar pelos parâmetros de pesquisa.
+for (let p of searchParams) {
+  console.log(p);
+}
+
+searchParams.has("topic") === true; // true
+searchParams.get("topic") === "api"; // true
+searchParams.getAll("topic"); // ["api"]
+searchParams.get("foo") === null; // true
+searchParams.append("topic", "webdev");
+searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
+searchParams.set("topic", "More webdev");
+searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
+searchParams.delete("topic");
+searchParams.toString(); // "q=URLUtils.searchParams"
+
+ +

Especificações

+ + + + + + + + + + + + + + + + +
EspecificaçãoEstadoComentário
{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}{{Spec2('URL')}}Definição inicial.
+ +

Compatibilidade Browsers

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FuncionalidadeChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{CompatChrome(49)}}{{CompatGeckoDesktop("29.0")}}{{CompatNo}}3610.1
entries(), keys(), values(), e suporte de for...of{{CompatChrome(49)}}{{CompatGeckoDesktop("44.0")}}{{CompatNo}}36{{CompatUnknown}}
USVString for constructor init object{{CompatVersionUnknown}}{{CompatGeckoDesktop("53.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
Record for constructor init object{{CompatUnknown}}{{CompatGeckoDesktop("54.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FuncionalidadeAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome para Android
Suporte básico{{CompatNo}}{{CompatChrome(49)}}{{CompatGeckoMobile("29.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}{{CompatChrome(49)}}
entries(), keys(), values(), e suport de for...of{{CompatNo}}{{CompatChrome(49)}}{{CompatGeckoMobile("44.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}{{CompatChrome(49)}}
USVString for constructor init object{{CompatNo}}{{CompatVersionUnknown}}{{CompatGeckoMobile("53.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}
Record for constructor init object{{CompatNo}}{{CompatUnknown}}{{CompatGeckoMobile("54.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Ver também

+ + + +
+
-- cgit v1.2.3-54-g00ecf