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

BCD tables only load in the browser

Especificação

Veja também