Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

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 ⁨julho de 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

Especificação

Veja também