diff options
Diffstat (limited to 'files/pt-br/web/api/urlsearchparams/get/index.html')
| -rw-r--r-- | files/pt-br/web/api/urlsearchparams/get/index.html | 109 |
1 files changed, 109 insertions, 0 deletions
diff --git a/files/pt-br/web/api/urlsearchparams/get/index.html b/files/pt-br/web/api/urlsearchparams/get/index.html new file mode 100644 index 0000000000..7a89676a9a --- /dev/null +++ b/files/pt-br/web/api/urlsearchparams/get/index.html @@ -0,0 +1,109 @@ +--- +title: URLSearchParams.get() +slug: Web/API/URLSearchParams/get +translation_of: Web/API/URLSearchParams/get +--- +<p>{{ApiRef("URL API")}}{{SeeCompatTable}} </p> + +<p>O métod <strong>get() </strong> da interface {{domxref("URLSearchParams")}}, retorna o primeiro valor associado ao parametro de busca fornecido.</p> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox">URLSearchParams.get(name)</pre> + +<h3 id="Parâmetros">Parâmetros</h3> + +<dl> + <dt>name</dt> + <dd>O nome do parâmetro à ser retornado.</dd> +</dl> + +<h3 id="Retorno">Retorno</h3> + +<p>Um {{domxref("USVString")}} se o parâmetro de pesquisa for encontrado; Caso contrário, <code><strong>null</strong></code>.</p> + +<h2 id="Exemplo">Exemplo</h2> + +<p>Se a URL da sua página é <code>https://example.com/?name=Jonathan&age=18</code> você pode obter o parâmetro 'name' e 'age' usando:</p> + +<pre class="default prettyprint prettyprinted"><code>let params = new URLSearchParams(document.location.search.substring(1)); +let name = params.get("name")<span class="kwd">; // retorna a string "Jonathan" +</span>let age = parseInt(params.get("age"), 10<span class="kwd">); // retorna o número 18</span></code> +</pre> + +<p>Buscar um parâmetro que não esteja presente na string de pesquisa, retornará <code><strong>null</strong></code>:</p> + +<pre><code>let address = params.get("address"); // null</code></pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Especificação</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('URL', '#dom-urlsearchparams-get', "get()")}}</td> + <td>{{Spec2('URL')}}</td> + <td>Definição inicial.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + +<div>{{CompatibilityTable}}</div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatChrome(49.0)}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</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>Basic support</td> + <td>{{CompatNo}}</td> + <td>{{CompatChrome(49.0)}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatChrome(49.0)}}</td> + </tr> + </tbody> +</table> +</div> |
