diff options
Diffstat (limited to 'files/pt-br/web/api/urlsearchparams/index.html')
-rw-r--r-- | files/pt-br/web/api/urlsearchparams/index.html | 177 |
1 files changed, 177 insertions, 0 deletions
diff --git a/files/pt-br/web/api/urlsearchparams/index.html b/files/pt-br/web/api/urlsearchparams/index.html new file mode 100644 index 0000000000..00080b0ae5 --- /dev/null +++ b/files/pt-br/web/api/urlsearchparams/index.html @@ -0,0 +1,177 @@ +--- +title: URLSearchParams +slug: Web/API/URLSearchParams +tags: + - API + - API de URL + - Experimental + - Interface + - Referencia +translation_of: Web/API/URLSearchParams +--- +<p>{{ApiRef("URL API")}}</p> + +<p>A interface <strong><code>URLSearchParams</code></strong> define métodos de utilização para trabalhar com query string de uma URL.</p> + +<p>Uma implementação do objeto <code>URLSearchParams</code> pode diretamente ser usado em uma estrutura {{jsxref("Statements/for...of", "for...of")}}, em vez de {{domxref('URLSearchParams.entries()', 'entries()')}}: <code>for (var p of mySearchParams)</code> é equivalente de <code>for (var p of mySearchParams.entries())</code>.</p> + +<h2 id="Construtor">Construtor</h2> + +<dl> + <dt>{{domxref("URLSearchParams.URLSearchParams", 'URLSearchParams()')}}</dt> + <dd>Construtor retorna um objeto <code>URLSearchParams</code>.</dd> +</dl> + +<h2 id="Propriedades">Propriedades</h2> + +<p><em>Esta interface não herda nenhuma propriedade.</em></p> + +<h2 id="Métodos">Métodos</h2> + +<p><em>Esta interface não herda nenhum método.</em></p> + +<dl> + <dt>{{domxref("URLSearchParams.append()")}}</dt> + <dd>Acrescenta um par de chave/valor específica com um novo parâmetro de busca.</dd> + <dt>{{domxref("URLSearchParams.delete()")}}</dt> + <dd>Exclui o parâmetro de busca informado, e seu valor associado, da lista de parâmetros de busca.</dd> + <dt>{{domxref("URLSearchParams.entries()")}}</dt> + <dd>Retorna um {{jsxref("Iteration_protocols","iterator")}} permitindo obter por todos os pares de chave/valor contidos neste objeto.</dd> + <dt>{{domxref("URLSearchParams.get()")}}</dt> + <dd>Retorna o primeiro valor associado ao parâmetro de busca informado.</dd> + <dt>{{domxref("URLSearchParams.getAll()")}}</dt> + <dd>Retorna todos os valores associados com o parâmetro de busca encontrado.</dd> + <dt>{{domxref("URLSearchParams.has()")}}</dt> + <dd>Retorna um {{jsxref("Boolean")}} indicando se cada um dos parâmetros de busca existe.</dd> + <dt>{{domxref("URLSearchParams.keys()")}}</dt> + <dd>Retorna um {{jsxref("Iteration_protocols", "iterator")}} permitindo obter todas as chaves dos pares de chave/valor contido neste objeto.</dd> + <dt>{{domxref("URLSearchParams.set()")}}</dt> + <dd>Define o valor associado ao parâmetro de busca com o valor informado. Se tiver mutios valores, exclua os outros.</dd> + <dt>{{domxref("URLSearchParams.toString()")}}</dt> + <dd>Retorna uma string contendo uma query string adequada pra usar numa URL.</dd> + <dt>{{domxref("URLSearchParams.values()")}}</dt> + <dd>Retorna um {{jsxref("Iteration_protocols", "iterator")}} permitindo obter todos os valores dos pares de chave/valor contido neste objeto.</dd> +</dl> + +<h2 id="Exemplo">Exemplo</h2> + +<pre class="brush: js">var stringParams = "q=URLUtils.searchParams&topic=api" +var paramsBusca = new URLSearchParams(stringParams); + +//Iterar os parâmetros de busca. +for (let p of paramsBusca) { + console.log(p); +} + +paramsBusca.has("topic") === true; // true +paramsBusca.get("topic") === "api"; // true +paramsBusca.getAll("topic"); // ["api"] +paramsBusca.get("foo") === null; // true +paramsBusca.append("topic", "webdev"); +paramsBusca.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev" +paramsBusca.set("topic", "More webdev"); +paramsBusca.toString(); // "q=URLUtils.searchParams&topic=More+webdev" +paramsBusca.delete("topic"); +paramsBusca.toString(); // "q=URLUtils.searchParams" +</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Especificação</th> + <th scope="col">Situação</th> + <th scope="col">Comentário</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_do_navegador">Compatibilidade do navegador</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Característica</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Suporte básico</td> + <td>{{CompatChrome(49)}}</td> + <td>{{CompatGeckoDesktop("29.0")}}</td> + <td>{{CompatNo}}</td> + <td>36</td> + <td>{{CompatNo}}</td> + </tr> + <tr> + <td><code>entries()</code>, <code>keys()</code>, <code>values()</code>, e suporte de <code>for...of</code></td> + <td>{{CompatChrome(49)}}</td> + <td>{{CompatGeckoDesktop("44.0")}}</td> + <td>{{CompatNo}}</td> + <td>36</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Característica</th> + <th>Android</th> + <th>Android Webview</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + <th>Chrome for Android</th> + </tr> + <tr> + <td>Suporte básico</td> + <td>{{CompatNo}}</td> + <td>{{CompatChrome(49)}}</td> + <td>{{CompatGeckoMobile("29.0")}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatChrome(49)}}</td> + </tr> + <tr> + <td><code>entries()</code>, <code>keys()</code>, <code>values()</code>, e suporte de <code>for...of</code></td> + <td>{{CompatNo}}</td> + <td>{{CompatChrome(49)}}</td> + <td>{{CompatGeckoMobile("44.0")}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatChrome(49)}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>Outras interfaces relacionadas com URL: {{domxref("URL")}}, {{domxref("URLUtils")}}.</li> + <li><a href="https://developers.google.com/web/updates/2016/01/urlsearchparams?hl=en">Google Developers: Easy URL manipulation with URLSearchParams</a></li> +</ul> + +<dl> +</dl> |