Sumário

Retorna o primeiro elemento dentro do documento (usando ordenação em profundidade, pré-ordenada e transversal dos nós do documento) que corresponde ao grupo especificado de seletores.

Sintaxe

element = document.querySelector(selectors);

Onde:

  • element é um objeto Element.
  • selectors é uma string que contém um ou mais seletores CSS separados por vírgulas.

Exemplo

Neste exemplo, o primeiro elemento no documento com a classe "myclass" é retornado:

var el = document.querySelector(".myclass");

Notas

Retorna null se nenhum resultado for encontrado; caso contrário, retorna o primeiro elemento correspondente.

Se o seletor utilizado for um ID e este ID foi erroneamente utilizado várias vezes no documento, ele retorna somente o primeiro elemento correspondente.

Gera uma exceção SYNTAX_ERR se o grupo de seletores utilizado for inválido.

querySelector() foi introduzido com a API de seletores.

Compatibilidade dos navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1 3.5 (1.9.1)
bug 416317
8 10 3.2 (525.3)
WebKit bug 16587
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 2.1 yes 9 10.0 3.2

Especificação

Veja também:

Etiquetas do documento e colaboradores

Colaboradores desta página: fernandosavio, teoli, AshfaqHossain, HenriqueSilverio
Última atualização por: fernandosavio,