files/pt-br/web/api/location/search/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

---
title: 'Location: search'
slug: Web/API/Location/search
tags:
  - API
  - Location
  - Propriedade
  - Search
translation_of: Web/API/Location/search
---
<div>{{ApiRef("Location")}}</div>

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

<p>Os navegadores modernos fornecem o <code><a href="/en-US/docs/Web/API/URLSearchParams/get#Examples">URLSearchParams</a></code> e o <code><a href="/en-US/docs/Web/API/URL/searchParams#Examples">URL.searchParams</a></code> para facilitar a análise dos parâmetros da querystring.</p>

<h2 id="Sintaxe">Sintaxe</h2>

<pre class="syntaxbox"><em>string</em> = <em>object</em>.search;
<em>object</em>.search = <em>string</em>;
</pre>

<h2 id="Exemplos">Exemplos</h2>

<pre class="brush: js">// Seleciona o elemento &lt;a id="myAnchor" href="https://developer.mozilla.org/en-US/docs/Location.search?q=123"&gt;
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")<span class="kwd">); // é o número 123</span>
</pre>

<h2 id="Especificação">Especificação</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Status</th>
   <th scope="col">Comentário</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', '#dom-location-search', 'search')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>Definição inicial.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{Compat("api.Location.search")}}</p>