---
title: Element.querySelector()
slug: Web/API/Element/querySelector
tags:
  - API
  - DOM
  - Elemento
  - Referencia
translation_of: Web/API/Element/querySelector
---
<div>{{APIRef("DOM")}}</div>

<p>Retorna o primeiro elemento descendente do elemento em que a função foi invocada e que corresponde aos seletores especificado. </p>

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

<pre class="syntaxbox"><var>elemento</var> = elementoBase.querySelector(seletores);
</pre>

<ul>
 <li><code>elemento</code> e<code> elementoBase</code> são objetos {{domxref("element")}}.</li>
 <li><code>selectores</code> é um grupo de  <a href="/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors">selectores</a>.</li>
</ul>

<h2 id="Example" name="Example">Exemplo</h2>

<p>Neste exemplo é retornado o primeiro elemento <code>style</code> que, ou não tem nenhum atributo type, ou tem o atributo type igual a  <code>text/css</code>:</p>

<pre class="brush:js">var el = document.body.querySelector("style[type='text/css'], style:not([type])");
</pre>

<h2 id="Notes" name="Notes">Notas</h2>

<p>Retorna <code>null </code>se nenhum elemento for encontrado; caso contrário retorna o primeiro elemento; </p>

<p>Lança uma exceção <code>SYNTAX_ERR</code> se o grupo de seletores é inválido.</p>

<p><span style="font-family: courier new;"><span>querySelector()</span></span> foi introduzido em WebApps API.</p>

<p>O argumento de string do <code>querySelector</code> deve seguir a sintaxe CSS. Veja exemplos concretos em {{domxref("document.querySelector")}}</p>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th>Browser</th>
   <th>Suporte</th>
   <th>Notas</th>
  </tr>
  <tr>
   <td>Internet Explorer</td>
   <td>8</td>
   <td>(IE8) apenas selectores CSS 2.1</td>
  </tr>
  <tr>
   <td>Firefox (Gecko)</td>
   <td><strong>3.5</strong> (1.9.1)</td>
   <td> </td>
  </tr>
  <tr>
   <td>Opera</td>
   <td>10</td>
   <td> </td>
  </tr>
  <tr>
   <td>Chrome</td>
   <td>1</td>
   <td> </td>
  </tr>
  <tr>
   <td>Safari (webkit)</td>
   <td>3.2 (525.3)</td>
   <td><a class="link-https" href="https://bugs.webkit.org/show_bug.cgi?id=16587">webk.it/16587</a></td>
  </tr>
 </tbody>
</table>

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

<ul>
 <li>{{spec("http://www.w3.org/TR/selectors-api/","Selectors API Level 1","rec")}}</li>
 <li>{{spec("http://www.w3.org/TR/selectors-api2/","Selectors API Level 2","wd")}}</li>
 <li>{{spec("http://dev.w3.org/2006/webapi/selectors-api2/","Selectors API Level 2","ed")}}</li>
</ul>

<h2 id="See_also" name="See_also">Veja Também</h2>

<ul>
 <li><a href="/en-US/docs/DOM/Element.querySelectorAll"><code>element.querySelectorAll</code></a></li>
 <li><a href="/en-US/docs/DOM/Document.querySelector"><code>document.querySelector</code></a></li>
 <li><a href="/en-US/docs/DOM/Document.querySelectorAll"><code>document.querySelectorAll</code></a></li>
 <li><a href="/en-US/docs/Code_snippets/QuerySelector">Code snippets for querySelector</a></li>
</ul>