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
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.