Document.querySelector()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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:

js
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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
querySelector

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Especificação

Veja também