Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
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 objetoElement.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
Retornanull se nenhum resultado for encontrado; caso contrário, retorna o primeiro elemento correspondente.
Se o seletor utilizado for umID e esteID foi erroneamente utilizado várias vezes no documento, ele retorna somente o primeiro elemento correspondente.
Gera uma exceçãoSYNTAX_ERR se o grupo de seletores utilizado for inválido.
querySelector() foi introduzido com a API de seletores.